Copyright: "Install / Easy" (c) 1994 by Kurt P. Herzog
Citation: "Install / Easy" (c) 1994 by Kurt P. Herzog


Install / Easy  -  Table of Contents

     "The Easy Windows Installer"

Introduction to Install / Easy

Creating your application installation

What's New in this version

Converting from an earlier version of Install / Easy

Special Issues

File versions & dates

File Compression

"Readme Text" files

Support for Languages other than English

Testing

Install / Easy Menu Commands

 File

 Data

 Preferences

Tools

 Help

Install / Easy main window pushbuttons

Additional Information about Install / Easy

 More about Install / Easy

 How to Register Install / Easy...

 Deinstalling Install / Easy...

 Warranty & Disclaimer

 Copyrights & other Legal Stuff...


Introduction To Install / Easy

Install / Easy is a complete system for quickly and easily creating a professional looking Windows application installation package.   It is used to install your application's files and programs on your user/client/customer's computer.

Install / Easy is usable on any machine running Microsoft Windows version 3.1 or later.

Your user/client/customer is referred to in this documentation as the "installer".

The installation process is referred to as "install" or "install program".

There are two main components to Install / Easy:

 The program INSTEASY.EXE

This program is used by you to describe your application for the installation process.

Click Here for more information about describing your application.

The program INSTALL.EXE

This program is used by your installer to install your application on his or her computer.

Click here for more information on how the installation of your application appears to the installer.

For information on how to pay for Install / Easy, and what you get when you do so, click here.

Click here to return to the Table of Contents


Introduction - INSTEASY.EXE

 The program INSTEASY.EXE

This program is used by you to describe your application for the installation process.

 Install / Easy is easy.  It does not require you to write any "scripts", learn yet another arcane language, or otherwise engage in any laborious programming efforts.  All data is supplied in clear and easy to use dialogs.

 Install / Easy is fast.  An installation for a typical application with a half-dozen or so files can be completed in under half an hour.

 Install / Easy is complete with an extensive on-line help system.  Just press "F1" any time for pop-up help about the current input field, or press the "Help" button in any dialog for a complete description.

 Install / Easy creates an application installation control file called INSTALL.INF.  This file is used by INSTALL.EXE and INSTALDR.EXE to install your application's programs and files on the installer's computer.  You will supply your programs and files, the INSTALL.INF control file, and the programs INSTALL.EXE and INSTALDR.EXE on your distribution disk(s) as a complete package.  You may also include one of the Language DLLs if necessary to support a language other than English.

For information on how to pay for Install / Easy, and what you get when you do so, click here.

Click here to return to the Table of Contents


Introduction - INSTALL.EXE

The program INSTALL.EXE

This program is used by your installer to install your application on his or her computer.  INSTALL.EXE creates a temporary directory on the installer's hard drive and copies the file INSTALDR.EXE to it.  INSTALDR then reads the file INSTALL.INF which you have created with the program INSTEASY.EXE INSTALL.INF contains all the instructions and data that describe your application installation package.

The installer typically places the first of your distribution disks into their removable disk drive and using Windows' Program Manager FILE menu executes "FILE|RUN A:INSTALL"  (or B:INSTALL).

Depending on the options you have chosen when you created the package, INSTALL.EXE will accomplish the following:

 Creates a temporary directory on the hard drive and copies the installation program INSTALDR (and any required Language DLL) to it.

 Display a "Welcome" screen with a brief message about your application.

 Present a proposed directory that your application programs and files will be installed into.  The installer is given an opportunity to change this directory.

 Validates the installation directory and creates it if necessary.

 Assures that the installation directory contains enough space to contain all of the files and programs to be installed.

 Presents a list of optional components that the installer can choose to install or not install.

 Presents a proposed name for a Program Manager Group that will contain all of the program/file icons for your application.  The installer may change the name of the Group or choose not to have it installed at all.

 Checks the internal version number or DOS date/time of each program and file being installed against any pre-existing file of the same name.  Later files with correct version data are not overwritten.

 Copies your application programs and files from the installation disk(s) to the installer's computer.  the installer is prompted for each successive disk as required.

 Decompress the files as they are installed.

 Keeps the installer informed of the installation progress with a sliding "percent-completed" gauge.

 Creates the Program Manager Group(s) as required and adds your icons to them.

 Updates or creates any Windows or private .INI files.

 Deletes the temporary directory created earlier, and all the temporary installation files it contains.

 Runs your application, or restarts Windows or reboots the computer if necessary.

For information on how to pay for Install / Easy, and what you get when you do so, click here.

Click here to return to the Table of Contents


Creating Your Application Installation

The file INSTALL.INF was copied to your hard disk as part of the Install / Easy package.  It is the file used to control the installation of the Install / Easy application, and furnishes a good example of a completed application installation.  Load INSTALL.INF into the Install / Easy editor (INSTEASY.EXE) and follow along with the following discussion.   As you enter each of the various dialog's fields press the F1 key for pop-up help for that field.  You may also press the "Help" button for a general discussion about each dialog and all of it's fields.

 Be sure you have thoroughly tested all of the components of your application.

 Start INSTEASY.EXE and open a new INSTALL.INF file.  See the main menu "File" topic for a general discussion of the INSTALL.INF file.  Save the INSTALL.INF file in the directory you wish to use for this project.  Install/Easy expects to find most, if not all of your application's distributable files and programs together in the "project" directory, though it is not required that you organize them in this fashion.

 Compress all of the files using COMPRESS.EXE (Optional).  Add the compressed file names to the application's file list.  You may compress any of your files except INSTALL.EXE and INSTALL.INF.

 For the general sequence of other data to be added see the main menu "Data" topic.  Enter the data required for each area.

 If desired, use the "Date-Time Stamp" tool to "stamp" all of the application's files with a consistent DOS file date and time.

 Copy INSTALL.EXE, INSTALDR.EXE, INSTALL.INF, and any required Language DLL to the root directory (not in a subdirectory) of the first Installation disk.  Copy all of your application's files and programs to their respective installation disks.  You may use the "Copy to Install Disks"tool to perform the copies automatically if you have entered the locations of all files.

 Test the installation from your newly-created installation disks.


Date/Time Stamper - Choose Files

Select one or more files for which you wish to change the Date and Time modified "stamp".

After choosing the menu command TOOLS|Data/Time stamp... choose one or more files from the list of files under File Name, or type the name of the file(s) in the File Name box.

You may also select files on another drive or directory by first switching to that drive or directory.

The fields and controls in the "Choose Files" dialog are:

 File Name

Choose the name of the document you want to open or type the filename.

 List Files of Type

Choose the type of files you want listed:

   "Executables      *.EXE,*.DLL,*.EX_,*.DL_ files

   "All files"               *.* files

 Directories

Choose the directory containing the files you want.

 Drives

Choose the drive where the files you want are located.

 OK button

Click or Press the "OK" to close the dialog and "stamp" the specified files.

 Cancel button

Click or Press the "Cancel" button to close the dialog without "stamping" any files.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


File Version Control

The install program will normally check for an existing version of each file as it is installed.  If no existing file  is found in the specified directory, the file is installed.  If a file with the same name exists in the specified directory the version will be checked.

   Windows programs will have their internal version resource compared to determine which file is the later version.

   Programs and files without version resource data will have their DOS file date-time stamps compared.

If the existing file is clearly of a later version (higher version number or later date) the file version from the installation disk will not be installed.  No notice is provided of this occurrence; it is completely transparent to the installer.

Installing a new version of a file implies deleting the previously installed version.  Install/Easy will delete the previous version only if it is in the same directory that will receive the new version.  If a file of the same name exists anywhere else it will not be deleted.

The default version checking may be overridden by checking the "Install Regardless" check box on the "Application Program/File" dialog for this file.  Note that the installer is not given the choice of overwriting later files.  This can only be done by overriding the default when defining the application installation package.

   This version of Install/Easy will not install a file that is currently in use by Windows.

If that situation occurs the installer is notified and given the opportunity to:

   1)  Close other Windows applications and try again;

   2)  Continue without installing the file; or

   3)  Abort the installation.

   This version of Install/Easy will fail if an attempt is made to overwrite an older version of a file marked "Read-Only".  The installer is notified of a DOS Error code 5 - "Access Denied".  The same error will occur if the installer attempts to install to a network directory to which they have insufficient rights.


"ZIP" Files

The most popular of the file compression utilities is PKWARE, composed of PKZIP and PKUNZIP.

Note that "zipped" files may be distributed without license.  However if you include a PKWARE expansion or self-extracting utility you must be licensed by them to do so.  Contact PKWARE for more information:

 PKWARE, Inc.

 9025 N. Deerwood Drive

 Brown Deer, WI 53223


"LZH" Files

The LHA file compression system is available on many Bulletin boards.  At this writing Version 2.12 was being distributed with no licensing requirements.


File Compression

Install / Easy supports file compression using Microsoft COMPRESS.EXE.  The install program makes use of the DLL "LZEXPAND.DLL" which is a component of Windows 3.1.  This DLL is used to perform the file copy operations whether or not the files are compressed.  Install / Easy will NOT function with Windows 3.0; nor with any Windows configuration that does not include LZEXPAND.DLL. and VER.DLL

You must use at least version 2 of COMPRESS.EXE.  Earlier versions are not compatible with LZEXPAND and will not work correctly.  You can detect if you have version 2 by executing COMPRESS from the DOS command prompt (with no parameters).  You should see the banner:

"Microsoft (R) File Compression Utility  Version 2.00"

"Copyright (C) Microsoft Corp. 1990-1992.  All rights reserved."

If you use COMPRESS.EXE to compress your files be sure to use the "/r" command line parameter to rename the compressed file.  Example "COMPRESS /r MYPROG.EXE" yields "MYPROG.EX_".

Enter the compressed renamed file (MYPROG.EX_ in this example) as the Program/File name in the "Application Program/File Dialog".  If you use Install / Easy's Tools|Compress feature you may have the compressed files added to the application file list automatically.

Files compressed with COMPRESS.EXE can also be manually expanded with the program EXPAND.EXE, which is also a component of Windows 3.1.

Any or all of your files may be compressed except INSTALL.EXE and INSTALL.INF.  It pays to pay close attention to the results of compression.  Some files actually become larger in the compression process!  In such a case, simply use the uncompressed version.

There is little advantage to using file compression if your application will ship on a single diskette without it.  If you distribute your application via bulletin board, the common "ZIP" file will yield superior compression results.  Another alternative for compressed distribution is the "LZH" file.

Install / Easy does not currently support automatic decompression with either ZIP or LZH files.  If you package your application with either of these methods, include a "read-me" file to assist your installer in getting your files decompressed and installed.  Here is an example:

- - - - - - - - - - - - - - - - - - - - - - - - - - -  snip/snip - - - - - - - - - - - - - - - - - - - - - -

Text file "README.TXT"

If you are installing from a diskette:

  1) From Program Manager click on the "File" menu

     or type "ALT-F".

  2) Choose "Run"

  3) Type "A:INSTALL" or "B:INSTALL" depending on which drive

     the installation diskette is in.

If you are installing from a down-loaded ZIP file:

  1) Create a temporary directory on drive C.

  2) Copy the Zipped archive file to the temporary directory

     and unzip the Installation files into it.

  3) From Program Manager click on the "File" menu

     or type "ALT-F".

  4) Choose "Run"

  5) Type "C:(temporary directory)\INSTALL"

  6) When installation is complete you may delete the temporary

     directory and the files it contains.

- - - - - - - - - - - - - - - - - - - - - - - - - - -  snip/snip - - - - - - - - - - - - - - - - - - - - - -


MORICONS.DLL

MORICONS.DLL is a resource-only DLL that is part of WINDOWS 3.1 (normally located in the Windows directory).   It consists of several dozen icons that can be assigned by the user however they feel appropriate.


"Read-me" Files

The initial screen that is displayed to your installer during the install process is designed to welcome them to your application and to provide a minimal amount of information on how to proceed.  If you find you need to present a more extensive amount of text to be read,  you should install one or more "Read-Me" files as part of your application.

Compose your text using Window's NOTEPAD or WRITE.  NOTEPAD is probably sufficient for short messages designed to be read only, say last minute changes or additions to more formally presented documentation.  If there is the intention to have the text printed, use WRITE and format it accordingly.

The text file should be installed to the application directory the same as any other file, and may be added to the Program Manager Group you create, with it's own icon.  It is not necessary to install the file as an icon in a PM group, but doing so makes it available to the installer until they decide they want to delete it.

Complete the following fields in the Program Manager Program Item dialog for each "read-me" file:

  Enter a meaningful description of the "read-me" file as the Program Item Name.  Example:  "Important information"

  Enter the name of the program that displays your "read-me" file as the Command Line.  Example: NOTEPAD.EXE

  Select the appropriate  directory from the drop-down directory list that describes where the program can be found, if required.  You need not specify a directory for NOTEPAD or WRITE, since they are typically located in the Windows directory.

  Enter the name of the "read-me" file as the command line parameter.  Example: "README.TXT"

  Select the appropriate directory from the drop-down directory list for the command line parameter that describes the location of the "read-me" file.  Example: "Application Directory".

  You may wish to assign a more distinctive icon to the item than the default icon that would normally be used for either WRITE.EXE or NOTEPAD.EXE.  (Both of these icons are readily understandable as representing a text file to be read, however).  You may use the Icon Resource file area to assign an icon from any file available, for example you might use MORICONS.DLL.

  If it is important that the installer reads the file before proceeding to execute your application, check the "On Completion - Run Program" radio button in the General Setup dialog and name the Read-me text file as the program to be executed.


Testing

Here are some things to think about and test:

  Test your installation package and your application using all three Windows video resolutions; i.e.: 640 x 480, 800 x 600, 1024 x 768.

  Test your application with a variety of strange and bizzare Windows desktop colors.  Particularly if you use a lot of color in your windows and dialogs, you may find that some of them become unreadable.

  Test your installation package and your application in both of Window's operating modes: 386-Enhanced and Standard.

  Use your completed installation package to install your application on several other systems.  A too-common failure is to forget to include certain DLLs that you may have taken for granted (Example: Borland's BWCC.DLL, or a VBX control).

  Spell-check all your read-me files.  Spell-check the text in your application's dialogs and menus.

  If you use a file-compression scheme, try decompressing everything and installing your application.


Drop-down Directory List

The list box supplies the following directories:

    "Application directory"        The directory where your application is being installed.

    "Windows directory"            The installer's WINDOWS directory.

    "Windows\System directory"      The installer's WINDOWS\SYSTEM directory.

    "Other directory (root relative)"       A directory is specified as part of the parameter.

    "No directory required"       A directory is not required in this situation.

You may specify a subdirectory of the indicated directory as part of the parameter entry.  For example if the application directory is "C:\FOO\BAR" and the "Application" directory is selected, the entry "SUBDIR" would resolve to "C:\FOO\BAR\SUBDIR".  Note that the subdirectory entry may NOT be preceded with "\".  You may also supply a complete path relative to the installation drive by selecting "Other directory" and entering the complete path (without the drive letter).


Displaying a "Read-me" with Notepad

1)  Check the "On Completion - Run Program" radio button.

2)  Install your readme text file in the application directory.

3)  Enter "NOTEPAD.EXE" as the Command Line and select the "Not Required" directory from the drop-down directory list..

4)  Enter the readme text file name as the Command Line Parameter and select the "Application" directory from the drop-down directory list.


Menu Command "File"

Install / Easy creates a file with the data necessary to install your application.  The default name for this file is "INSTALL.INF", though you can name it whatever you want.  If you do use another name your installer will have to specify it during the installation process.  This feature could be used to place multiple applications on the same disks; each with it's own .INF file.

See the Menu Command "Preferences" for information on making back-ups of your .INF file.

The "File" menu supplies the common file functions:

 New

A new file is created.  If there is an unsaved file in the editor you will be reminded to save it before proceeding.

 Open...

Opens an existing file.  If there is an unsaved file in the editor you will be reminded to save it before proceeding.

 Save

Saves a previously opened or saved file to disk using the original file name.  The file remains in the editor and may continue to be modified.  If the file is new and not previously saved this option is not available and will be "grayed" on the menu.

 Save As...

Saves a previously opened or new file to disk using a new name.  You will be prompted for a new name and directory.  The file remains in the editor and may continue to be modified.  When a previously saved file is "Saved as" (with a new name) the original file on disk remains unchanged.

 Exit

This command terminates the program.   If there is an unsaved file in the editor you will be reminded to save it before proceeding.

 Pick-list of previously opened files

The last 5 files selected from the File|Open menu are listed in order, with the most recently used at the top of the list (#1).  Choosing a file and pressing "Enter" or double-clicking will load the file into the Install / Easy editor.   If there is an unsaved file in the editor you will be reminded to save it before proceeding.


Menu Command "Data"

The "Data" menu provides access to the major dialogs used to create the application setup control file (INSTALL.INF).  These items can also be accessed through Install / Easy's main window pushbuttons.  In general you will complete these dialogs in the order listed, though there is  no requirement to do so.

 General setup data...

The General setup dialog is used to define basic information about the application.

 Read-me text for initial welcome...

The Read-me Text dialog is used to enter the initial greeting that is displayed when the installation process is initiated by executing the Install program.

 Optional installation...

The Optional installation dialog defines 0, 1, 2 or 3 sets of programs or files to be installed at the installer's choice.

 Programs/Files...

The Application Programs/Files dialog lists the application's programs and files and provides access to the Program/File dialog.  The latter is used to define each program and file to be installed as part of the application.

 Distribution Disks...

The Distribution Disks dialog lists the application's distribution disks and the application's files.  Files may be assigned to individual disks.  This dialog also provides access to the Disk dialog which is used to provide information about each of the distribution disks in the application.  The Program/File dialog is also available  which is used to define each program and file that is part of the application.

 Program Manager Groups...

The Program Manager Groups dialog lists all Program Manager groups that will be created or added to by the application.  Access is provided to the Group Data dialog which is used to describe each required group, and the Program Manager Program Item dialog which is used to describe each program item to be included in the group.

 Setup .INI Files...

The INI File Parameters dialog lists all entries to be made to any required Windows or application initialization (INI) files.  Access is provided to the INI Parameter dialog, which is used to specify the individual INI entries.

 Close

This command terminates the program.

If there is an unsaved file in the editor you will be reminded to save it before proceeding.


Menu Command "Preferences"

The "Preferences" menu allows you to set the following options.  The option is enabled when a check-mark [image]  appears by it in the menu:

 Make backup files

 Install / Easy will make a backup copy of the current .INF file before writing the changed version to disk.  The backup file has it's extension changed to .BAK.

If unchecked no backup is made.

 Use 3-d Dialogs

Note:  You must have the Microsoft DLL Ctl3d or Ctl3dV2 installed for this option to be available.

 All dialogs are displayed in the Microsoft Ctl3d format.

If unchecked dialogs are displayed in the normal format.

 Mouse Jumps

 The mouse pointer will automatically move ("Jump") to the default pushbutton in each dialog.

If unchecked the mouse pointer does not "Jump".

 Warning Beeps

 Install / Easy accompanies warning dialogs & messages with the appropriate system sound.

If unchecked only catastrophic errors are accompanied with the appropriate system sound.

 Compression

Install / Easy will execute the Microsoft COMPRESS.EXE utility if you desire.

One of the following three options must be chosen:

 In View - File compression takes place in a visible window (default).

     Hidden - File compression takes place hidden from view.

     As Icon - File compression takes place as an icon on the desktop.

 Date/Time Stamp

Install / Easy can "stamp" your application's files with a consistent Date/Time.

One of the following two options must be chosen:

      All Items - All the application's files will be date-time "stamped".

 Only Items in Project Directory  - Only the application files in the project directory will be date-time "stamped" (default).


Menu Command "Help"

The "Help" menu allows you to choose from the following items:

 Help_Index

Displays the topics in Install / Easy Help (Table of Contents)

 Search for Help On...

Opens the Search dialog for Install / Easy Help.  Using the Search dialog box, you can look up Help information by using keywords.

 How to Use Help...

Describes how to use the Help system.

 About  Install / Easy ...

More information about Install / Easy.

Each of Install / Easy's dialogs has a "Help" button that can be pressed or clicked, or you may press the F1 key at any time to call the Help system.


File Open dialog

Opens an Install / Easy .INF file that already exists.  You may open only one file at a time.  However, you may run multiple copies of Install / Easy; each with a different INSTALL.INF file.

To open an existing file:

After choosing the menu command FILE|OPEN choose a file from the list of files under File Name, or type the name of the file in the File Name box.

You may also open a file in another drive or directory by first switching to that drive or directory.

The fields and controls in the Open File dialog are:

 File Name

Choose the name of the document you want to open or type the filename.

 List Files of Type

Choose the type of file you want listed:

   "Install Info"          * .INF files

   "Inc. Backups"    *.INF, *.BAK files

   "All files"               *.* files

 Directories

Choose the directory containing the file you want.

 Drives

Choose the drive where the file you want is located.

 OK button

Click or Press the "OK" to close the dialog and open the specified file.

 Cancel button

Click or Press the "Cancel" button to close the dialog without opening a file.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


File Save As dialog

Saves and names an Install / Easy Installation control file. You can use the Save As command to:

   Save an existing file with a new name.

   Save an existing file on a different drive or in a different directory.

.

After choosing the Save As command, choose the options you want.  The fields and controls in the File Save As dialog are:

 File Name

Type a name for the document that is no more than eight characters long. Type a filename extension only if you do not want the default extension ".INF".

 Save Files of Type

Choose the type of file you want listed:

   "Install Info"          * .INF files

   "Inc. Backups"    *.INF, *.BAK files

   "All files"               *.* files

 Directories

Choose the directory in which you want the file to be saved.

 Drives

Choose the drive in which you want the file to be saved.

 OK button

Click or Press the "OK" to close the dialog and save the specified file.

 Cancel button

Click or Press the "Cancel" button to close the dialog without saving the file.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Application Name

The Application Name may be up to 35 characters in length and may contain spaces and/or special characters.  This field is required.

The Application Name is appended to "Installing" and appears in the caption bar of all the dialogs and messageboxes displayed by the Install program during the installation of your application.

Example: Application Name is "Foo Bar App";

caption bars will be: "Installing Foo Bar App".


Main Install Window Title

The Main Install Window Title appears at the top of the main Install window while your application is being installed.  This field is limited to a single line of up to 80 characters and may contain spaces and special symbols.  The actual number of characters that may be displayed may be much less than 80 depending on the character mix and the selected font size.  The maximum size that can be used using the default font is approximatly 22 characters.  You will need to shorten the title if it will not fit on the screen at 640 x 480 resolution.  Be sure you test your installation at all Windows resolutions.

This field is optional and may be left blank.


Main Install Window Footer

The Main Install Window Footer appears at the bottom of the main Install window while your application is being installed.  This field is limited to a single line of up to 80 characters and may contain spaces and special symbols.  The actual number of characters that may be displayed may be much less than 80 depending on the character mix and the selected font size.  The maximum size that can be used using the default font is approximatly 50 characters.  You will need to shorten the footer if it will not fit on the screen at 640 x 480 resolution.  Be sure you test your installation at all Windows resolutions.

This field is optional and may be left blank.


Default Installation Directory

The Default Installation Directory locates where your application will be installed on the installer's computer.  The directory is required and must conform to the rules and conventions for DOS paths.  Choose from the Windows, Window\System  directory, or a specific directory by selecting the appropriate radio button:

   "As specified" - The path must begin with a drive letter, a colon and a backslash.

..."Windows, Windows\System" - You may specify subdirectories by entering the subdirectory only.  Do not precede it with a backslash (\) character.  If you do not wish to specify a subdirectory leave the directory text field blank.

The installer may modify the supplied default to any valid directory for his/her machine.  If the directory does not exist the Install program will create it.  You may specify additional subdirectories of the Default Installation Directory with the individual programs to be installed.  The following are all valid examples of a Default Installation Directory:

   c:\

   d:\myapp

   c:\myapp\mydir\

The following are examples of a valid Windows  directory subdirectory:

   fonts

   wav\funny\


On Completion

The On Completion radio buttons control what the Install program does at the completion of the installation of your application.  In cases 2), 3) and 4) below the installer is notified and given the opportunity to defer the operation.  The choices are:

1)  Just Quit.  The install program terminates in the normal fashion.

2)  Restart Widows.  The install program shuts-down Windows and restarts it.  Use this choice if your application has made changes to the WIN.INI, SYSTEM.INI, or other files and those changes need to be put into effect before your application can be executed.

3)  Reboot System.  The install program shuts-down Windows and performs a "warm" boot on the computer.  Use this choice if the installation has made changes to the PATH, installed device drivers, or otherwise made changes requiring a system boot prior to your application being executed.

4)  Run Program.  The install program terminates and then runs the specified program.  Use this choice (or #5) if you wish to launch your application or some other program.

5)  Run Program (no choice).  The install program terminates and runs the specified program.  The installer is not given the choice of canceling the operation.


Command Line

The Command Line field is only available when one of the "On Completion Run Program" radio buttons is checked.   Enter the program name to be executed.  If the program is in the installed application directory, the windows directory or the windows system directory do not include a path on the command line, but do select the directory from the drop-down list.  If no path is required select "Not Required"  You may also specify the complete path if necessary by selecting "Other" and entering the path relative to the root of the installation drive.


Command Line Parameters

The Command Line Parameter field is only available when one of the "On Completion Run Program" radio buttons is checked.  Enter any command line parameters, switches, etc. as required by the program to be run.  You may include a path as part of the first parameter by selecting the directory from the drop-down directories list.


Allow Installer

If the "YES" button is checked the installer will be allowed to change the default name of the Group that you have specified as the Main Group (first in Group List).  The installer will also be able to choose to cancel installation of all PM Groups.  If the "NO" button is checked the installer has no control over Program Manager Group installation other than with the "Optional Components" feature.


General Setup

The General Setup dialog is used to describe basic information about your application and how the install program will appear to the installer.

The data fields and controls on the "General Setup" dialog are:

 Application Name

The Application Name may be up to 35 characters in length and may contain spaces and/or special characters.  This field is required.  The Application Name is appended to "Installing" and appears in the caption bar of all the dialogs and message boxes displayed by the Install program during the installation of your application.  Example: Application Name is "Foo Bar App"; caption bars will be: "Installing Foo Bar App".

 Main Install Window Title

The Main Install Window Title appears at the top of the main Install window while your application is being installed.  This field is limited to a single line of up to 80 characters and may contain spaces and special symbols.  The actual number of characters that may be displayed may be much less than 80 depending on the character mix and the selected font size.  The maximum size that can be used using the default font is approximatly 22 characters.  You will need to shorten the title if it will not fit on the screen at 640 x 480 resolution.  Be sure you test your installation at all Windows resolutions.

This field is optional and may be left blank.

 Main Install Window Footer

The Main Install Window Footer appears at the bottom of the main Install window while your application is being installed.  This field is limited to a single line of up to 80 characters and may contain spaces and special symbols.  The actual number of characters that may be displayed may be much less than 80 depending on the character mix and the selected font size.  The maximum size that can be used using the default font is approximatly 50 characters.  You will need to shorten the footer if it will not fit on the screen at 640 x 480 resolution.  Be sure you test your installation at all Windows resolutions.

This field is optional and may be left blank.

 Default Installation Directory

The Default Installation Directory locates where your application will be installed on the installer's computer.  The directory is required and must conform to the rules and conventions for DOS paths.  Choose from the Windows, Window\System  directory, or a specific directory by selecting the appropriate radio button:

   "As specified" - The path must begin with a drive letter, a colon and a backslash.

   "Windows, Windows\System" - You may specify subdirectories by entering the subdirectory only.  Do not precede the subdirectory with a backslash (\) character.  If you do not wish to specify a subdirectory leave the directory text field blank.

The installer may modify the supplied default to any valid directory for his/her machine.  If the directory does not exist the Install program will create it.  You may specify additional subdirectories of the Default Installation Directory with the individual programs to be installed.  The following are all valid examples of a Default Installation Directory:

   c:\

   d:\myapp

   c:\myapp\mydir\

The following are examples of a valid Windows  directory subdirectory:

   fonts

   wav\funny\

Check the check box to prohibit the installer from modifying the specified directory.  If you do so, the directory is not displayed to the installer, nor is the directory checked for sufficient space for the application's files and programs.  Use caution specifying this option because if you specify a drive on the installer's machine that does not exist, the installation will fail.

 On Completion

The On Completion radio buttons control what the Install program does at the completion of the installation of your application.  In cases 2), 3), and 4) below the installer is notified of the intended action and given the opportunity to cancel.  The choices are:

1)  Just Quit.  The install program terminates in the normal fashion.

2)  Restart Widows.  The install program shuts-down Windows and restarts it.  Use this choice if your application has made changes to the WIN.INI, SYSTEM.INI, or other files and those changes need to be put into effect before your application can be executed.

3)  Reboot System.  The install program shuts-down Windows and performs a "warm" boot on the computer.  Use this choice if the installation has made changes to the PATH, installed device drivers, or otherwise made changes requiring a system boot prior to your application being executed.

4)  Run Program.  The install program terminates and then runs the program specified below.  Use this choice if you wish to launch your application or some other program.  This option may be used to launch Windows  NOTEPAD with a "read-me" file displayed if desired.

5)  Run Program (no choice).  As in "Run Program" above, except installer is not given the opportunity to cancel.

 Command Line

The Command Line field is only available when one of the "On Completion Run Program" radio buttons is checked.   Enter the program name to be executed.  If the program is in the installed application directory, the windows directory or the windows system directory you do not need to include a path.  If a path is required select it from the drop-down list.  If no path is required choose "No directory required"  You may also specify a.complete path on the command line by selecting "Other directory (root-relative).  This option allows you to specify a directory unrelated to the application directory, but relative to the installation drive.

 Command Line Parameters

The Command Line Parameter field is only available when one of the "On Completion Run Program" radio buttons is checked.  Enter any command line parameters, switches, etc. as required by the program to be run.  You may include a path for the first parameter by selecting the appropriate directory from the drop-down list.

 Installer Language

Select the language of the intended installer from the drop-down list.  The default is US English.  If you select a language other than US English you must be sure to include the correct language support DLL with your application distribution package.  See the "Language Support" topic for a complete discussion

 Design Install Window Button

Click or press the "Design Install Window" button to commit the changes that have been entered on the "General Setup" dialog (same as pressing "Ok") and start the Install Window designer dialog.  This dialog allows you to customize the appearance of the main window of INSTALL.EXE.

 .INF File last updated

The date and time the current file was last updated.  Install / Easy maintains this field.

 OK button

Click or Press the "OK" to close the dialog and accept the data as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing any of the data fields.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Installer

The person who is installing your application on their computer.


Install Program

INSTALL.EXE - the Install / Easy component program that  the installer runs to install your application on their computer.

INSTALDR.EXE - The Install/Easy component program that INSTALL.EXE uses to copy your application's files and programs from the removable drive (floppy or CDROM) to the permanent drive.


Welcome "Read-me"

The "Read-me" dialog is displayed  when the installer begins the installation process by executing the Install program.  It gives you a chance to tell him/her a little about your application and give any necessary critical instructions.  Only that portion inside the indicated border is displayed to the installer.  The format will be exactly as you enter it, including any "tabs" and "returns".  If you leave the text field completely blank (i.e.: no message) the dialog will not be displayed to the installer.

The "Read-me" dialog contains the following fields and controls:

 Main text

This message is limited to approximately 175 words, and should be composed in the language of the intended installer.  See the "Language Support" topic for a complete discussion.

To enter a "tab" use "Ctl-Tab".

To end a line use "Ctl-Enter".

 OK button

Click or Press the "OK" to close the dialog and accept the message as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing the message text.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Read-me Text

To enter a "tab" use "Ctl-Tab".

To end a line use "Ctl-Enter".

This message is limited to approximately 175 words and should be composed in the language of the intended installer.


Optional Group Description

Define the groups in order, beginning with Optional Group 1. Enter into the text box a brief description of the component group. Each of the three description fields is limited to approximately 35 words or 165 characters, and should be composed in the language of the intended installer.

To enter a "tab" use "Ctl-Tab".

To end a line use "Ctl-Enter".


Optional Component Group Descriptions

The "Optional Groups" dialog (not to be confused with "Program Manager Groups") is used to define components of your application that the installer can optionally choose to install or not.  This dialog is optional.  If your application does not have any optional components you do not need to complete any part of this dialog.  You may define 1, 2, or 3 optional groups.   The components themselves are assigned to the respective group on the "Program/File" dialog.

When the "Optional Groups"dialog is presented to the installer only the groups that have been defined will be displayed.  If no groups are defined this dialog is not displayed.   The installer selects the components he/she chooses to install by selecting the "Yes-No" radio buttons for each group.   The total disk space required is displayed on the dialog and is updated as groups are chosen.

The fields and controls on the "Optional Groups" dialog are:

 Optional Group 1

 Optional Group 2

 Optional Group 3

Define the groups in order, beginning with Optional Group 1.  Enter into the text box a brief description of the component group.  Each of the three description fields is limited to approximately 35 words or 165 characters, and should be composed in the language of the intended Installer.  (See the "Language Support" topic for more information).

To enter a "tab" use "Ctl-Tab".

To end a line use "Ctl-Enter".

 OK button

Click or Press the "OK" to close the dialog and accept the data as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing any of the data fields.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


File List

Double-clicking the selected program in this list is the same as pressing the "Change file..." button.

The list contains the following items for all programs/files that have been defined:

The file's name.

The Disk ID of the installation disk the file is assigned to.

The Optional Component Group (if any) the file is installed with.

The major directory the file is installed into.

The file's size in bytes (compressed size if compressed).


Add File Button

Click or press this button to add a new Program or File to the list.


Change File Button

Click or press this button to change the selected Program/File.


Delete File Button

Click or press this button to delete the selected Program/File.


Installable Programs/Files
Application Programs/Files

The "Application Programs/Files" dialog lists all of your application's files and provides access to the "Program/File" dialog where detailed data for each file is supplied.

Files and programs may be added to the list in several ways.

Choose one or several files by clicking or pressing "Add List..." below.

Add a single file by pressing "Add File..."

Files may be added as they are compressed.  See the "Compress Files" topic for details.

One or more files may be "dragged" from File Manager and dropped onto the INSTEASY window or icon.  (You must have an INSTALL.INF file open for this feature to be available).

NOTE:  be sure you include INSTALL.EXE, INSTALDR.EXE, any required Language DLL, and your application's INSTALL.INF in your application's file list.  These files must be located in the root directory (not in a subdirectory) of the first distribution disk.

The fields and controls on the "Application Programs/Files" dialog are:

 Program/File list

Double-clicking the selected program in this list is the same as pressing the "Change file..." button.  The list contains the following items for all programs/files that have been defined:

  The file's name.

  The Disk ID of the installation disk the file is assigned to.

  The Optional Component Group (if any) the file is installed with.

  The major directory the file is installed into.

  The file's size in bytes (compressed size if compressed).

 Program/File description

This field displays the description of the file that is selected in the Program/Files list.  It appears below the Program/Files list at the bottom of the dialog.

 Program/File location

This field displays the location of the file that is selected in the Program/Files list.  It appears below the Program/Files list at the bottom of the dialog.

 Add file...

Click or press this button to add a new Program or File to the list.

 Add list...

Click or press this button to add or update a list of Programs and/or Files.  You will be presented with a standard "Choose Files" dialog from which you may make a selection of one or many programs or files.  If a chosen program or file does not exists in the Program/File list, it will be added to the list and the file size (both compressed and uncompressed), the description from the version data resource, and the file location will be entered.  If the file name exists in the list, the description, sizes and location are updated.

 Change file...

Click or press this button to change the selected Program/File.

 Delete file...

Click or press this button to delete the selected Program/File.

 Close button

Click or Press the "Close" button to close the dialog.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Program/File Name

The name and extension of the file or program.  Must be a valid DOS file name and must be present.  Once a Program/File name has been entered it may not be changed.  If you later discover it to be wrong, you must delete the entire Program/File record and reenter it correctly.  Fields other than the Program/File name may be changed at any time.

Examples:  "MYPROG.EXE",  "MYFILE.TXT", "MYPROG.DL_" (compressed), etc.


Description

This description is displayed to the installer by the Install program as the file is being copied to the installer's computer.  This description is limited to a maximum of 75 characters and may contain spaces and special characters.  Note that the format is presented as centered, one or two lines as necessary.  You may "force" the line-break by entering "Ctrl-Enter" at the desired end of the first line


Disk ID

Each file/program will be assigned to a specific installation disk.  You may do that here if the list is available, or later with the "Distribution Disks" dialog.  The Disk ID assignment may be easily changed at any time.


Source Disk Subdirectory

The source disk subdirectory is optional.  It is used if you desire to have your installation Program/Files assigned to subdirectories on your distribution disks.  The default would be to have all Program/Files in the root directories of the distribution disks, without subdirectories.  Entries in this field must conform to standard DOS rules for directory names.  Leave blank if not used, otherwise enter a valid path.   Do not enter a drive letter or colon.   Do not enter either a leading or a trailing "\".   Do not include the Program/File name.

Examples:  "SUBDIR",  "FOO\BAR",  "EXAMPS"


Uncompressed File Size

Enter the original size of the Program/File in bytes.  This field is required and must be a valid number.  It is important that the exact size is supplied as it will be needed to assign the Program/Files to the distribution disks and is used during the installation process to indicate the disk space required.


Compressed File Size

If the Microsoft COMPRESS.EXE program is being used for file compression enter the compressed size of the Program/File in bytes.  It is important that the exact size is supplied as it will be needed to assign the Program/Files to the distribution disks.  If compression is not being used leave this field blank.  This version of Install / Easy only supports file compression using COMPRESS.EXE.


Install Requirements

Check the appropriate radio button.  The default is to always install the Program/File.  The file may be optionally installed if it is assigned to an "Optional Component Group" and the installer chooses to include that group.  You should select "Never" if this file is not to be copied to the installer's computer (for example INSTALL.EXE and INSTALL.INF, both of which would be included on your installation disks).


Destination Subdirectory

The Destination subdirectory field is available only when the "Install - Never" radio button is not checked. Select the appropriate directory where this Program/File will be installed from the drop-down directories list..

The drop-down list supplies the following directories:

    "Application"        The directory where your application is being installed.

    "Windows"            The installer's WINDOWS directory.

    "Win/System"      The installer's WINDOWS\SYSTEM directory.

    "Other Dir."            Specify a complete directory relative to the root of the installation drive.

A subdirectory of the selected directory may be supplied as the keyboard entry.   Entries in this field must conform to standard DOS rules for directory names.   Note that the Program/File name is never included as part of the subdirectory.   If the subdirectory does not exist the Install program will create it.

Example:  If the application directory is "C:\FOO\BAR" and the "Application" directory is selected the entry  "SUBDIR" would resolve to "C:\FOO\BAR\SUBDIR".  Note that the subdirectory entry can NOT be preceded with "\".  You may also supply a complete path by selecting the "Other directory." from the drop-down list, and entering the complete path relative to the root of the installation drive (without the drive letter).


Program/File

The "Program/File" dialog supplies the required information for each program or file in your application that will be installed on the installer's computer.

The fields and controls on the "Program/File" dialog are:

 Program/File Name

The name and extension of the file or program.  Must be a valid DOS file name and must be present.  Once a Program/File name has been entered it may not be changed.  If you later discover it to be wrong, you must delete the entire Program/File record and reenter it correctly.  Fields other than the Program/File name may be changed at any time.

Examples:  "MYPROG.EXE",  "MYFILE.TXT", "MYPROG.DL_" (compressed), etc.

 Find Program/File

Press or click the button to open a "Choose File" dialog from which you may select a file or program to be added to the application's list.  If you are adding a file, you may select any file that does not already exist in the list.  If you are updating an existing file, you must select the file with the name specified in the "Program/File Name" field.  If a chosen program or file does not exists in the Program/File list, it will be added to the list and the file size (both compressed and uncompressed), the description from the version data resource, and the file location will be entered.  If the file name exists in the list, the description, sizes and location are updated.

 Program/File location

This field displays the location of the file on your development system.  If used, the location must be specified correctly as a valid DOS directory beginning with a drive letter.  If not used, this field must be blank.  You may enter the location directly, or use the "Find Program/File" browse button.  If an application file is moved to a different directory on your development system after it has been entered here, you must update it's location.

Install/Easy's "Copy to Installation Disks"feature will only copy files with a specified location to the installation disks.

 Description

A description of the file.  This description is displayed to the installer by the install program as the file is being copied to the installer's computer.  This description is limited to a maximum of 75 characters and may contain spaces and special characters.  Note that the format is presented as centered, one or two lines as necessary.  You may "force" the line-break by entering "Ctrl-Enter" at the desired end of the first line.

The install program installs your files and programs on the users machine in alphabetic order by file name, within each installation disk.  The install program displays a "status" dialog while the files are being copied, which includes the file name and location, and the description.  The install program continues to display the last description until another is supplied.  This means you can use the same description for a series of files without having to enter it for each file.  For example if you have a series of example files you may enter the description "Examples" for the first file only (alphabetically) and it will continue to be displayed until another file is installed with a different description.  If you wish to "clear" the description you should enter a single "space" character as the description of the program or file required.

 Disk ID

Each file/program will be assigned to a specific installation disk.  You may do that here if the list is available, or later with the "Distribution Disks" dialog.  The Disk ID assignment may be easily changed at any time.

 Source disk subdirectory

The source disk subdirectory is optional.  It is used if you desire to have your installation Program/Files assigned to subdirectories on your distribution disks.  The default would be to have all Program/Files in the root directories of the distribution disks, without subdirectories.  Entries in this field must conform to standard DOS rules for directory names.  Leave blank if not used, otherwise enter a valid path.  Do not enter a drive letter, colon, or a leading or trailing "\".   Do not include the Program/File name.

Examples:  "SUBDIR",  "FOO\BAR",  "EXAMPS"

 Uncompressed File Size

Enter the original size of the Program/File in bytes.  This field is required and must be a valid number.  It is important that the exact size be supplied as it will be needed to assign the Program/Files to the distribution disks, and is used during the installation process to indicate the disk space required.

 Compressed File Size

If the Microsoft COMPRESS.EXE program is being used for file compression enter the compressed size of the Program/File in bytes.  It is important that the exact size is supplied as it will be needed to assign the Program/Files to the distribution disks.  If compression is not being used leave this field blank.  This version of Install / Easy only supports file compression using COMPRESS.EXE.

 Install Requirements

Check the appropriate radio button.  The default is to always install the Program/File.  The file may be optionally installed if it is assigned to an "Optional Component Group" and the installer chooses to include that group.  Choose "Never" if this file is included on the installation disks but not copied to the installer's computer.  (Examples: INSTALL.EXE, INSTALL.INF).

 Destination subdirectory

The Destination subdirectory field is available only when the "Install - Never" radio button is not checked.

Select the appropriate directory where this Program/File will be installed from the drop-down directories list.

The drop-down list supplies the following directories:

    "Application"        The directory where your application is being installed.

    "Windows"            The installer's WINDOWS directory.

    "Win/System"      The installer's WINDOWS\SYSTEM directory.

    "Other Dir."             Specify a directory relative to the root of the installation drive.

A subdirectory of the selected directory may be supplied as the keyboard entry.   Entries in this field must conform to standard DOS rules for directory names.   Note that the Program/File name is never included as part of the subdirectory.   If the subdirectory does not exist the install program will create it.

Example:  If the application directory is "C:\FOO\BAR" and the "Application" directory is selected from the drop-down list, the entry  "SUBDIR" would resolve to "C:\FOO\BAR\SUBDIR".  Note that the subdirectory entry must not be preceded with "\". You may also supply a complete path relative to the installation drive by choosing "Other Directory." and entering the complete path (less the drive letter).

 Install Regardless

If the checkbox is checked the installer program will not check for an existing later version before installing this program/file.  This overrides the default, which is to always check versions.  See the "Version Control" topic for more information.

 OK button

Click or Press the "OK" to close the dialog and accept the data as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing any of the data fields.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Distribution Disks

The "Distribution Disks" dialog is used to assign your application's programs and files to individual disks for distribution.  You must have at least one Distribution disk; you may define as many as are required to contain all of your application's files.

You must leave enough room on the first installation disk ("DISK 01") for the INSTALL.EXE and INSTALDR.EXE programs, any required language DLL, and the INSTALL.INF installation control file.  Approximately 80K bytes are required, depending upon the size of the INSTALL.INF file and whether or not INSTALDR is compressed.  These files must all be located in the root directory (not in a subdirectory).

The fields and controls on the "Distribution Disks" dialog are:

 Disk Label for Disk ID:

This field displays the Disk Label for the selected installation Disk ID.

 Disk ID:

The Disk ID list lists all of the Installation disks.  Choose the disk you wish to assign programs and files to by selecting it (highlight it).  Double-clicking will execute the "Distribution Disk" dialog for the selected Disk ID.

 Add a Disk ID...

Click or press this button to add a new Distribution Disk to the list.

 Change a Disk ID...

Click or press this button to change the Distribution Disk Label for the selected Disk ID.

 Delete Disk ID...

Click or press this button to delete the selected Disk ID.  You may not delete the last remaining Disk ID.   There must always be at least one defined.  If there are programs or files assigned to a deleted Disk ID they will be returned to the "Unassigned Programs/Files" list.

 Programs/Files:

The "Programs/Files" list lists all programs and files assigned to the selected Installation Disk ID.  Double-clicking an item in the list will execute the "Program/File" dialog where you may make changes to the item's description and other characteristics.  You may choose multiple items in this list by holding the "Ctrl" key while clicking the desired items.

 On this disk:

Indicates the number of and total size of all programs/files assigned to the selected Disk ID.  The size indicated is the compressed size if the item(s) are compressed.  By inspecting this total you can determine how much room remains on the selected Disk ID for additional programs/files.

 Selected:

Indicates the number of and total size of all programs/files on the selected Disk ID that are selected (highlighted).  Pressing the "Drop >" button will remove the selected item(s) and return them to the "Unassigned Programs/Files" list.

 Unassigned Programs/Files:

The "Unassigned" list contains all of your application's defined programs/files that have not been assigned to a distribution disk.  For each item the program/file name is indicated, whether or not the installation of this item is optional, and the size of the item  (compressed size if the item is compressed).  Double-clicking an item in the list will execute the "Program/File" dialog where you may make changes to the item's description and other characteristics.  You may choose multiple items in this list by holding the "Ctrl" key while clicking the desired items.

 Unassigned:

Indicates the number of and total size of all programs/files that remain unassigned to any installation Disk ID.  The size indicated is the compressed size if the item(s) are compressed.  By inspecting this total you can determine approximately how many installation disks will be required to contain the remaining items.

 Selected:

Indicates the number of and total size of all programs/files on the "Unassigned" list that are selected (highlighted).  Pressing the "< Add" button will move the selected item(s) to the "Programs/Files" list of the selected Disk ID.

 < Add & Drop >

Click or press these buttons to move selected items between the "Unassigned Programs/Files" and "Programs/Files" lists.

 Close button

Click or Press the "Close" button to close the dialog.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


< Add & Drop > Buttons

Click or press these buttons to move selected items

between the "Unassigned Programs/Files" and

"Programs/Files" lists.


Unassigned Programs/Files

The "Unassigned" list contains all of your application's defined programs/files that have not been assigned to a distribution disk.  For each item the program/file name is indicated, whether or not the installation of this item is optional, and the size of the item  (compressed size if the item is compressed). Double-clicking an item in the list will execute the "Application Program/File" dialog where you may make changes to the item's description and other characteristics.  You may choose multiple items in this list by holding the "Ctrl" key while clicking the desired items.


Programs/Files

The "Programs/Files" list lists all programs and files assigned to the selected Installation Disk ID.  Double-clicking an item in the list will execute the "Application Program/File" dialog where you may make changes to the item's description and other characteristics.

You may choose multiple items in this list by holding the "Ctrl" key while clicking the desired items.


Delete Disk ID...

Click or press this button to delete the selected Disk ID. You may not delete the last remaining Disk ID.   There must always be at least one defined.  If there are programs or files assigned to a deleted Disk ID they will be returned to the "Unassigned Programs/Files" list.


Change Disk Id...

Click or press this button to change the Distribution Disk Label for the selected Disk ID.


Add a Disk ID...

Click or press this button to add a new Distribution Disk to the list.


Disk ID List

The Disk ID list lists all of the Installation disks.  Choose the disk you wish to assign programs and files to by selecting it (highlight it).  Double-clicking is the same as pressing the "Change Disk ID.." button


Distribution Disk

The "Distribution Disk" dialog is used to define each disk necessary to contain your application's programs and files for distribution.  You must define at least one disk; you may define as many as are necessary.  Each disk defined must have a unique disk identifier ("Disk ID").  Install / Easy assumes "DISK 01" as the default identifier for the first disk.  If you prefer some other ID, add a Disk with your own ID and then delete DISK 01.  You may not change a Disk ID; you may only add and delete.  Note that if you delete a disk that has had programs/files assigned to it they will have to be reassigned to some other disk.

The installer never sees the Disk ID.  They will be prompted to change installation disks at the appropriate time using the "Disk Label" field.  Install / Easy assumes "Installation Disk No. 1" as the label for DISK 01.  You may change this description to anything you like, but remember that it should be meaningful to the installer.

The distribution disks are processed by INSTALL.EXE in sequence by Disk ID.  It is important to be sure the first disk receives the required files INSTALL.EXE, INSTALDR.EXE, any required language DLL, and INSTALL.INF.  If you add additional installation disks after assigning programs/files to the existing disks, be sure your first disk contains the required files in it's root directory.  The "first" disk is always at the top of the "Disk ID List" on the "Distribution Disks" dialog.  The disks are listed (and processed by INSTALL) in alphabetic sequence.

The Distribution Disk dialog contains the following fields and controls:

 Disk ID

The Disk ID is limited to 10 characters and may contain spaces and special symbols.

 Disk Label

The Disk Label is limited to 66 characters and may contain spaces and special symbols.  Note that it may be one or two lines and will be centered.  It is displayed to the installer exactly as entered here.

 OK button

Click or Press the "OK" to close the dialog and accept the data as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing any of the data fields.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Disk Label

The installer is prompted to change installation disks at the appropriate time using the "Disk Label" field.  This description may be anything you like, but remember that it should be meaningful to the installer.

The Disk Label is limited to 66 characters and may contain spaces and special symbols.  Note that it may be one or two lines and will be centered.  It is displayed to the installer exactly as entered here.


Disk ID_1
Disk ID

Each disk defined must have a unique disk identifier ("Disk ID"). Install / Easy assumes "DISK 01" as the default identifier for the first disk.  If you prefer some other ID, add a Disk with your own ID and then delete DISK 01.  You may not change a Disk ID; you may only add and delete.  The Disk ID is limited to 10 characters and may contain spaces and special symbols.


Program Manager Groups List

The list contains the Group Name of all PM Groups that have been defined.

Double-clicking the selected Group Name in this list is the same as pressing the "Change a PM Group..." button.


Add a PM Group...

Click or press this button to add a new Program Manager Group to the list.


Change a PM Group...

Click or press this button to change the selected Program Manager Group.


Delete PM Group...

Click or press this button to delete the selected Program Manager Group. When you delete a Program Manager Group item any Program Manager Program Items you may have entered for this Group are also deleted.


Program Items List

The list contains the Program Item Names of all Program Manager Program Items that have been defined for the Program manager Group Name that is selected in the Program Manager Group list.

Double-clicking the selected PM Program Item in this list is the same as pressing the "Change program..." button.


Add Program...

Click or press this button to add a new Program Manager Program Item to the list.


Change Program...

Click or press this button to change the selected Program Manager Program Item.


Delete Program...

Click or press this button to delete the selected Program Manager Program Item.


Program Manager Groups

The Program Manager Groups dialog lists all of the Windows Program Manager Groups that the install program  will create.  (If you name a group that  already exists on your installer's computer the install program adds the program icons to it and leaves the original items in place).  This dialog also provides access to the "Program Manager Group Data" dialog where you enter information for each Program Manager Group, and the "Program Manager Program Item" dialog where you enter information for each program or file icon you wish added to the Group.

Do not confuse Program Manager Groups with "Optional Group Descriptions", which is where you describe components of your application that the installer may choose to install or not install.

Do not confuse Program Manager Program Items with "Application Files".  Files may be installed without being included in a PM Group; and items can be added to a PM Group without necessarily having been installed as part of your application.  You can include in a Group any item that may already exist on your installer's machine.  A common example would be to install a "Read-me" .TXT file as part of your application and then create an Icon for Windows Notepad to display it.

You may create no Groups or as many as you require.   You may wish to allow the installer to change the first Group's name.  This feature is only available if you answer "Yes" to the "Allow installer to rename..." option (see below),  and if used will also allow the installer to choose to not install the group(s) at all.  The change-name feature is the only case in which the installer has any control in Program Manager Group Installation other than through the "Optional Components" feature.  They can, of course, modify or delete any PM Groups after the installation is complete.

The fields and controls on the "Program Manager Groups" dialog are:

  Allow Installer to rename PM Group

If the "YES" button is checked the installer will be allowed to change the default name of the Group that you have specified as the Main Group (first in Group List).  The installer will also be able to choose to cancel installation of all PM Groups.  If the "NO" button is checked the installer has no control over Program Manager Group installation other than with the "Optional Components" feature.

 Program Manager Group list

The list contains the Group Name of all PM Groups that have been defined.

Double-clicking the selected Group Name in this list is the same as pressing the "Change a PM Group..." button.

 Add PM Group...

Click or press this button to add a new Program Manager Group to the list.

 Change PM Group...

Click or press this button to change the selected Program Manager Group.

 Delete PM Group...

Click or press this button to delete the selected Program Manager Group.

When you delete a Program Manager Group item any Program Manager Program Items you may have entered for this Group are also deleted.

 Program Items list

The list contains the Program Item Names of all Program Manager Program Items that have been defined for the Program manager Group Name that is selected in the Program Manager Group list.

Double-clicking the selected PM Program Item in this list is the same as pressing the "Change program..." button.

 Add Program...

Click or press this button to add a new Program Manager Program Item to the list.

 Change Program...

Click or press this button to change the selected Program Manager Program Item.

 Delete Program...

Click or press this button to delete the selected Program Manager Program Item.

 Close button

Click or Press the "Close" button to close the dialog.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Program Manager Group Name

The Group Name appears under the Group Icon in the Program Manager window.  This name is required, must be unique, and may not be blank.  A maximum of 30 characters including spaces may be used.


Group File Name

The Group File Name may be used to specify the name and path of the .GRP file that Program Manger assigns to this group when it is created.  Unless you have some specific reason for doing so, it is STRONGLY recommended that you leave this field blank and accept the Program Manager default name and path that will be assigned during the installation.  If you must use this field enter a complete path beginning with a drive letter.   Example: "C:\WINDOWS\MYGROUP.GRP".


Group Creation Requirements

Check the "Always created" button if this PM Group should always be created.  This is the default and must be selected if you are not using the "Optional Components" feature.  Check the "Create with Option #1, #2, or #3" button respectively to create this PM Group only when you are using the "Optional Components" feature.  The Group will be installed only if the installer has chosen to install this optional component of your application.  A typical use of this feature may be to allow the installer to choose whether or not to install a program in the Windows Start-up Group.


Show Group

Choose how you wish the Program Manager Group to be displayed to the

installer as the install program adds the Program Manager Program Items to it:

   Normal - The PM Group is shown in it's normal size.

   Minimized - The PM Group is shown as an icon.

   Maximized - The PM Group is shown full-screen.


Enter Program Manager Group Data

The "Program Manager Group Data" dialog supplies the required information for each Program Manager Group that you wish the install program to create or modify on your installer's computer.

The fields and controls on the "Program Manager Group Data" dialog are:

 Program Manager Group Name

The Group Name appears under the Group Icon in the Program Manager window.  This name is required, must be unique, and may not be blank.  A maximum of 30 characters including spaces may be used.

 Group File Name

The Group File Name may be used to specify the name and path of the .GRP file that Program Manger assigns to this group when it is created.  Unless you have some specific reason for doing so, it is STRONGLY recommended that you leave this field blank and accept the Program Manager default name and path that will be assigned during the installation.  If you must use this field enter a complete path beginning with a drive letter.   Example: "C:\WINDOWS\MYGROUP.GRP".

 Group Creation Requirement radio buttons

Check the "Always created" button if this PM Group should always be created.  This is the default and must be selected if you are not using the "Optional Components" feature.

Check the "Create with Option #1, #2, or #3" button respectively to create this PM Group only when you are using the "Optional Components" feature.  The Group will be installed only if the installer has chosen to install this optional component of your application.  A typical use of this feature may be to allow the installer to choose whether or not to install a program in the Windows Start-up Group.

 Show Group radio buttons

Choose how you wish the Program Manager Group to be displayed to the installer as the install program adds the Program Manager Program Items to it:

   Normal - The PM Group is shown in it's normal size.

   Minimized - The PM Group is shown as an icon.

   Maximized - The PM Group is shown full-screen.

 OK button

Click or Press the "OK" to close the dialog and accept the data as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing any of the data fields.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


PM Group Name

The Group Name appears under the Group Icon in the Program Manager window.  This name is required, must be unique, and may not be blank.  A maximum of 30 characters including spaces may be used.


Program Manager Program Item Name

The Program Manager Program Item Name appears under the Program Icon in the Program Manager Group window.  This name is required, must be unique, and may not be blank.  A maximum of 40 characters including spaces may be used.


Command Line_1
Command Line

This field is required.   Enter the program name to be executed.  If the program is to be installed in the application directory, the windows directory or the windows system directory do not include a path and select the directory from the drop-down list.  If no path is required select "Not Required"  You may also specify the complete path if necessary, or you may specify a subdirectory of one of the three standard directories (application, windows, windows/system).


Command Line Parameter

The Command Line Parameter field is optional.  Enter any command line parameters, switches, etc. as required by the program to be run.  You may include a path for the first parameter by selecting the directory from the drop-down directories list.


Start-up Directory

The Start-up directory is optional.  If not specified Windows will set the start-up directory to the directory the executing program is in.   You may  supply a Start-up directory by selecting "Other Directory."  from the drop-down directories list and entering the complete path relative to the root of the installation drive (do not enter the drive letter).  You may also choose one of the "standard" directories from the drop-down directories list.  You may specify a subdirectory of the indicated directory as part of the directory entry.  For example if the application directory is "C:\FOO\BAR" and the "Application" directory is selected the entry  "SUBDIR" would resolve to "C:\FOO\BAR\SUBDIR".  Note that the subdirectory entry is NOT preceded with "\".


Create Program Manager Program Item

The default is to always install this item as an icon in the Program Manager Group.  If this item is installed as part of an "Optional Component" group check the appropriate radio button to install the item only when the installer has chosen to install that component.


Icon Resource File

To use the program's default icon leave this entire group blank.  If the program has no icon, or you wish to specify a specific icon, enter the name of the file containing the icon here and select the appropriate directory to it's location from the drop-down directories list.


Icon Index

If your program contains multiple icons, this is the index position of the desired icon beginning with zero.  Zero is the default (for the first icon in the file).  You will typically use this field if you specify an icon that is located in another file; for example if you use an icon in Program Manager or in MORICONS.DLL.  For an example of a program item that uses the "Mailbox" icon from Program Manager press the "Help" button.


Icon Position in Group

You may position the icon at a specific location within the PM Group by specifying the X and Y coordinates of the upper left-hand corner of the icon relative to the upper left-hand corner of the Group window.  The dimensions are in pixels.  A typical icon is 32 pixels wide and high.  Leaving the "Icon Position" fields set to zero will cause the icon to be positioned  within the PM Group at the next available location, which is the default.


Shortcut Key

You may assign a Program Manager "Hot-Key" to the program by checking a combination of Ctrl, Alt, and Shift and specifying the Key character.  When Program Manager is running the user can access the application by pressing the "Hot-Key" combination defined here.  Leave all four fields blank if you do not use this feature.  See your Windows Program Manager documentation for more information.


Run Minimized

Check this box if you wish the program to be started as an Icon. Leave blank to start the program normally.


Menu Command "Tools"

The "Tools" menu provides access to these useful accessories.

 Compress...

This version of Install / Easy supports file compression with the Microsoft utility COMPRESS.EXE.  This menu provides access to the "Compress Files" dialog where you may run COMPRESS.EXE to compress the application's files.  You must have the COMPRESS.EXE utility installed to use this feature.

 Date-Time Stamp...

Opens the "Date-Time Stamper" dialog which can be used to "stamp" your application's files with a consistent date and time of last modification.

 Version Data...

Opens the "Version Data Inspector" dialog which may be used to examine any Windows program for the presence and status of internal versioning data.

 Copy to Install Disks...

Copies all of the application's files to their respective installation disks, prompting you to load each as needed.  This menu option is only available when an INSTALL.INF file is loaded and contains no unsaved changes.


Program Manager Program Item

This dialog defines all of the data required for each program or file icon that will be installed in a Program Manager Group.  This information is separate and distinct from the "Application File" data.

The fields and controls on the "Program Manager Program Item" dialog are:

 Program Manager Program Item Name

The Program Manager Program Item Name appears under the Program Icon in the Program Manager Group window.  This name is required, must be unique, and may not be blank.  A maximum of 40 characters including spaces may be used.

 Command Line

This field is required.   Enter the program name to be executed.  If the program is to be installed in the application directory, the windows directory or the windows system directory do not include a path and select the appropriate directory from the drop-down directories list.  If no path is required choose "Not Required"  You may also specify the complete path if necessary, or you may specify a subdirectory of one of the three standard directories (application, windows, windows/system).

 Command Line Parameter

The Command Line Parameter field is optional.  Enter any command line parameters, switches, etc. as required by the program to be run.  You may include a path for the first parameter by choosing the directory from the drop-down directories list.

 Start-up Directory

The Start-up directory is optional.  If not specified Windows will set the start-up directory to the directory the executing program is in.   You may  supply a Start-up directory by choosing "Other Directory." from the drop-down directories list, and entering the complete path relative to the root of the application drive (do not specify the drive letter).  You may also specify one of the "standard" directories from the list.  You may specify a subdirectory of the indicated directory as part of the directory entry.  For example if the application directory is "C:\FOO\BAR" and the "Application" directory is selected the entry  "SUBDIR" would resolve to "C:\FOO\BAR\SUBDIR".  Note that the subdirectory entry is NOT preceded with "\".

 Create Program Manager Program Item radio buttons

The default is to always install this item as an icon in the Program Manager Group.  If this item is installed as part of an "Optional Component" group check the appropriate radio button to install the item only when the installer has chosen to install that component.

 Icon Resource File

To use the program's default icon leave this entire group blank.  If the program has no icon, or you wish to specify a specific icon, enter the name of the file containing the icon here and select the proper directory for that file from the drop-down directories list.

 Icon Index Number

If your program contains multiple icons, this is the index position of the desired icon beginning with zero.  Zero is the default (for the first icon in the file).  You will typically use this field if you specify an icon that is located in another file; for example if you use an icon in Program Manager or in MORICONS.DLL.  See an example below of a program item that uses the "Mailbox" icon from Program Manager.

 Icon Position in Group

You may position the icon at a specific location within the PM Group by specifying the X and Y coordinates of the upper left-hand corner of the icon relative to the upper left-hand corner of the Group window.  The dimensions are in pixels.  A typical icon is 32 pixels wide and high.  Leaving the "Icon Position" fields set to zero will cause the icon to be positioned  within the PM Group at the next available location, which is the default.

 Shortcut Key

You may assign a Program Manager "Hot-Key" to the program by checking a combination of Ctrl, Alt, and Shift and specifying the Key character.  When Program Manager is running the installer can access the application by pressing the "Hot-Key" combination defined here.  Leave all four fields blank if you do not use this feature.  See your Windows Program Manager documentation for more information.

 Run Minimized

Check this box if you wish the program to be started as an Icon.

Leave blank to start the program normally.

 OK button

Click or Press the "OK" to close the dialog and accept the data as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing any of the data fields.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


INI File list

The information for each parameter displayed includes the INI file name, the Section within the INI file (enclosed in "[  ]" ), and the Keyword followed by the parameter data.  For more information on the format of INI parameters see your Windows API documentation.

Double-clicking the selected INI parameter in this list is the same as pressing the "Change INI..." button.


Add INI...

Click or press this button to add a new INI parameter to the list.


Change INI...

Click or press this button to change the selected INI parameter.


Delete INI...

Click or press this button to delete the selected INI parameter.


INI File Parameters

The "INI File Parameters" dialog lists all Windows INI file entries that your application may need to change or add.  Install / Easy can add entries to any of the Windows INI files.  You may also create and enter the defaults for your own application's INI file if it requires one.

This dialog also provides access to the "INI File Parameter" dialog where you will enter the data required for each parameter.

Changes made to Windows' (or any other) existing INI files will replace any previous entry with the same Section/Keyword.  Your entry does not "Add-on" to a list if one exists.  For example if you enter a "RUN=FOOBAR" INI parameter to WIN.INI only FOOBAR will be run, replacing any other entries on the "RUN=" parameter that may have previously existed.  Use caution with changes to files other than your application's own private .INI.

The fields and controls on the "INI File Parameters" dialog are:

 INI Parameter list

The information for each parameter displayed includes the INI file name, the Section within the INI file (enclosed in "[  ]" ), and the Keyword followed by the parameter data.  For more information on the format of INI parameters see your Windows API documentation.

Double-clicking the selected INI parameter in this list is the same as pressing the "Change INI..." button.

 Add INI...

Click or press this button to add a new INI parameter to the list.

 Change INI...

Click or press this button to change the selected INI parameter.

 Delete INI...

Click or press this button to delete the selected INI parameter.

 Close button

Click or Press the "Close" button to close the dialog.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


INI File Name

Enter the name of the INI file to be created/modified.  This must be a valid DOS file name with the extension .INI.  Example:   "MYPROG.INI".  The default location for INI files is the windows directory, but you may select any of the standard directories from the drop-down directories list.  Private INI files should normally be installed in the application's directory, but this is not a requirement.


Section

Enter the Section name the parameter will be listed under.  Do not enter the "[  ]" characters associated with Section names.  This field is limited to 128 characters, may contain spaces, but  may not be blank.


Keyword

Enter the Keyword used for this parameter.  Do not enter the "=" character associated with Keywords.  This field is limited to 128 characters, may contain spaces, but may not be blank.


Data

Enter the data for this INI parameter.  You may include a directory as the initial part of the parameter by selecting it from the drop-down directories list.  This field is limited to 128 characters, may contain spaces, and may be blank.


INI File Parameter Entry

The "INI File Parameter" dialog supplies the required information for each INI parameter that you wish the install program to install on your installer's computer.  All of the fields on this dialog are required except for the Data field.

The fields and controls on the "INI File Parameter" dialog are:

 File Name

Enter the name of the INI file to be created/modified.  This must be a valid DOS file name with the extension .INI.  Example:   "MYPROG.INI".  The default location for INI files is the windows directory, but you may select a different directory from the drop-down directories list.  Private INI files should normally be installed in the application's directory, but this is not a requirement.

 Section

Enter the Section name the parameter will be listed under.  Do not enter the "[  ]" characters associated with Section names.  This field is limited to 128 characters, may contain spaces, but  may not be blank.

 Keyword

Enter the Keyword used for this parameter.  Do not enter the "=" character associated with Keywords.  This field is limited to 128 characters, may contain spaces, but may not be blank.

 Data

Enter the data for this INI parameter.  You may include a directory as the initial part of the parameter by selecting it from the drop-down directories list.  This field is limited to 128 characters, may contain spaces, and may be blank.

 Create or Update INI Item radio buttons

The default is to always create or update this item.  If this item is installed as part of an "Optional Component" group check the appropriate radio button to install the item only when the installer has chosen to install that component.

 OK button

Click or Press the "OK" to close the dialog and accept the data as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing any of the data fields.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Windows Start-up Group

Windows 3.1 may contain a Program Manager Group that contains programs to be executed when Windows starts.  This Group is commonly named "StartUp", but may be different.


About Install / Easy

Install / Easy  was written in Borland Pascal

by:	  Kurt P. Herzog

 1440 N.E. Tenth Street

 Grants Pass, Oregon 97526 USA

You can reach the author by E-Mail on CompuServe at 72122,2023

From the Internet send Mail to  72122.2023@compuserve.com

Click here for information on how to register Install / Easy with the author.

Release History:

December 1, 1994 Release 1.4

  Added new features:

File Version & Date checking

Support for languages other than English.

Automatic creation of Installation disks.

Customizable Main Install Window appearance with optional 3d dialogs.

New hard-disk resident installer program.

"Add-list" method of adding Application files.

"Drag&Drop" Application files.

Update existing PM Icons or add new ones.

Version inspector.

Date-Time stamp.

Shell support for COMPRESS.EXE.

Option to prevent installer changing default installation directory.

Optional installation of INI file items.

Option to force execution of a program at installation completion.

  Changed INSTALL.EXE to assume files in same directory as INSTALL.INF.

  Increased INI file section & keyword sizes to 128 characters

  Increased Main Install Title & Footer to 80 characters each

  Fixed bug INI file directories not being created.

  Set selection in "Files" list to an adjacent item when a file is deleted.

  Fixed problem occurring with some multiple disk installations.

  Removed "Mouse-jump" feature from INSTALL.EXE.

August 6, 1994 Release 1.3...Bug fixes:

  Corrected error with using "other" installation directories.

  Corrected problem with commas in PM Group names.

  Corrections/Additions to Help file

June 18, 1994 Release 1.2...Bug fixes:

  Corrected error in installing to windows\system directory in some cases

  Corrected error in creating icons for programs optionally not installed.

June 1, 1994 Release 1.1  (Initial public release)


How to Register Install / Easy

Install / Easy is Shareware.  Shareware is not "free" software!  If you find this program useful please register with the author by paying the regular registration fee for this program of $29.95 (US).  If this program is not worth $29.95 to you, don't use it!

When you register (pay for) Install / Easy you will receive a license number, that when installed, will remove the shareware reminder screens from both the Editor and the Installer programs.  You may then use the system to distribute your programs.  There are no run-time, distribution, quantity or other fees other than the one-time registration fee.

Registered users also will receive notification of the next release of Install / Easy.

The author is depending on your voluntary registration to keep up his morale and encourage him to produce bigger and better Shareware programs (He also has 3 college-age children and a wife to support).

Please pass along copies of Install / Easy to your friends and favorite bulletin boards.  Be sure to include all of the original distribution package, as supplied on the original installation disk.

Click here to register NOW!

Click here for Warranty & Disclaimer information

Click here for Copyright information.


Registration Form

(Print this form on your printer by selecting "Print Topic" from the Help "File" Menu.)

Install / Easy Registration Form                                                        Version 1.4  12/01/94

Mail this form (with your check or money order in US funds) to:

Kurt P. Herzog

1440 N.E. Tenth Street

Grants Pass, OR 97526 USA                                                  Today's Date: _______________

PLEASE PRINT OR TYPE:

Company Name:  __________________________________________________________

Your Name:  _______________________________________________________________

Address:       _______________________________________________________________

City:                 _______________________________________________________________

State:              ______________________    Postal Code:  ____________  Country:  _______

E-Mail Address or telephone:   ________________________________________________

Register Install / Easy for each machine on which the program is used.

Enclose $29.95 (Check or Money Order in US funds) for each copy of

Install / Easy being registered:

Number of copies__________  x  $29.95        =            $____________

(Optional)    Enclose an additional $4.95

 for a return copy of the latest version

 of Install / Easy:  (  ) 3.5" disk  (  ) 5.25" disk                _____________

                                        Total enclosed (US Funds)    $_____________

(The remainder of this is optional, but the author would like to know...)

Where did you get your copy of Install / Easy?

CIS Forum, BBS or FTP site:  _________________________________

__________________________________________________________

Comments?  Criticism? Accolades?

__________________________________________________________

__________________________________________________________

THANKS FOR YOUR SUPPORT!


Registering Install / Easy

When you register with the author you will receive a receipt with your name and registration number.  You must enter your name and registration number exactly as shown on the receipt.  The spacing, capitalization, and any special characters must be entered exactly as shown.

Thank You for your support of shareware  and Install / Easy.


Deinstalling Install / Easy

HOW TO REMOVE Install / Easy FROM YOUR SYSTEM

__________________________________________________

Sorry Install / Easy doesn't meet your needs at  this time.

Here is what you do to get rid of it:

The files originally installed on your hard disk were:

 CTL3D.DLL

 INSTADEU.DLL

 INSTAFRA.DLL

 INSTAITA.DLL

 INSTALDR.EXE

 INSTALL.EXE

 	 INSTALL.INF

 INSTAPTG.DLL

 INSTCOMP.BAT

  	 INSTCOMP.PIF

 INSTDUMP.ICO

 INSTDUMP.TXT

 INSTEASY.EXE

 INSTEASY.HLP

 INSTEASY.INI

 INSTHELP.DLL

 INSTWNTY.TXT

All of these files should be together in the directory in which they were installed.  The default installation directory is "C:\INSTEASY", but any directory could have been used.  If you are unsure where they are located choose "Search.." from the File Manager "File" menu and enter "INSTEASY.*" as the file name to search for.  Choose the root directory of the installation drive (most commonly "C:\") and choose to search all subdirectories.  When you locate the files simply delete them.

If you installed Install / Easy in it's own directory, that is, by itself, you need only select that directory in File Manager and click "Delete".

If the Install / Easy icons created during the installation are still in their own group (and you have added nothing else to the group) just select the group in Program Manager, and from the Program Manager File Menu choose "Delete".

If you have moved the icons to other groups you will have to track them all down and delete them individually from those groups.

Install/Easy does not modify your CONFIG or AUTOEXEC files, nor modify any Windows INI files (except INSTEASY.INI), nor does it change any File Manager or Registry associations.

Please pass your unregistered installation disk along to someone else... maybe they can use the program  (and the author can use the registration fees!)

The author would like to hear from you about your experience with this program.  Where do you feel it is inadequate?  Why doesn't it do the job for you?  What would make it better?

Click here for information on how to contact the author.

Thanks for trying Install / Easy...


Warranty & Disclaimer

License Agreement:

-----------------------------

This software is provided on a trial basis for a 60 (sixty) day period. This is intended to allow 30 days to decide on the purchase of this software, and 30 days to purchase a copy.  After 60 days, should you decide not to purchase this software, you must remove all copies from your system.  By using this software you are agreeing to these terms.

Warranty:

--------------

This  software  is sold on an as-is basis.  The author (Kurt P. Herzog) specifically disclaims all warranties, expressed or implied.  In no event shall the author be liable for any loss of profit or any other damage including but not limited to special, incidental, consequential or other damages including damages to a third party.  By using this software you are agreeing to these terms.  If these terms are not agreeable, do not use this software.


Copyrights & Other Legal Stuff

Install / Easy is Copyright © 1994 (All Rights Reserved)

by:	  Kurt P. Herzog

 1440 N.E. Tenth Street

 Grants Pass, Oregon 97526 USA

You can reach the author by E-Mail on CompuServe at 72122,2023

From the Internet send Mail to  72122.2023@compuserve.com

________________________________________________________

WINDOWS and MS-DOS are trademarks of the Microsoft Corporation, copyright 1990-1993.

Borland Pascal, Turbo Pascal and Turbo Pascal for Windows are trademarks of  Borland International, copyright 1983, 1990-1993.

PKWARE, PKZIP, PKUNZIP and PKSFX  are registered trademarks of PKWARE, Inc.

U.S. Government Restricted Rights:

----------------------------------------------------

Use, duplication or disclosure by the Government is subject to restrictions set fourth in subparagraph (a) through (d) of the Commercial Computer Restricted Rights clause at FAR 52.227-19 when applicable, or subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-1013, and in similar clauses in the NASA FAR Supplement.


File|New

A new file is created.

If there is an unsaved file in the editor you will

be reminded to save it before proceeding.


File|Open

Opens an existing file.

If there is an unsaved file in the editor you

will be reminded to save it before proceeding.


File|Save

Saves a previously opened or saved file to disk

using the original file name.  The file remains in the

editor and may continue to be modified.  If the file is

new and not previously saved this option is not

available and will be "grayed" on the menu.


File|SaveAs

Saves a previously opened or new file to disk

using a new name.  You will be prompted for a

new name and directory.  The file remains in

the editor and may continue to be modified.

When a previously saved file is "Saved as"

(with a new name) the original file on disk

 remains unchanged.


File|Exit

This command terminates the program.

If there is an unsaved file in the editor you

will be reminded to save it before proceeding.


File|(Pick-list)

The last 5 files selected from the File|Open menu

 are listed in order, with the most recently used at the top

 of the list (#1).  Choosing a file and pressing "Enter" or

 double-clicking will load the file into the Install / Easy editor.


Data|General setup data...

The General Setup dialog is used to define basic information about the application.


Data|Read-me text for initial welcome...

The Welcome "Readme" dialog is used to enter the initial greeting that is displayed when the installation process is initiated


Data|Optional installation...

The Optional Group Descriptions dialog defines 0, 1, 2 or 3

sets of programs or files to be installed at the user's choice.


Data|Programs/Files...

The Application Programs/Files  dialog lists the application's programs and files and provides access to the Program/File dialog.  The latter is used to define each program and file to be installed as part of the application.


Data|Distribution disks...

The Distribution Disks dialog lists the application's distribution disks and the application's files.  Files may be assigned to individual disks. This dialog also provides access to the Distribution Disk dialog which is used to provide information about each of the distribution disks in the application.  The Program/File dialog is also available  which is used to define each program and file that is part of the application.


Data|Program Manager groups...

The Program Manager Groups dialog lists all Program Manager groups that will be created or added to by the application.  Access is provided to the PM Group Description dialog which is used to describe each required group, and the Program  Manager Program Item dialog which is used to describe each program item to be included in the group.


Data|Setup .INI files...

The INI File Parameters dialog lists all entries to be made to any required Windows or application initialization (INI) files.  Access is provided to the INI File Parameter Entry dialog which is used to specify the individual INI entries.


Data|Close

This command terminates the program.

If there is an unsaved file in the editor you

will be reminded to save it before proceeding.


Preferences|Make backup files

 Install / Easy will make a backup copy of the current .INF file before writing the changed version to disk.  The backup file has it's extension changed to .BAK.

If unchecked no backup is made.


Preferences|Use 3-D dialogs

 All dialogs are displayed in the Microsoft Ctl3d format.

If unchecked dialogs are displayed in the normal format.

Note:  You must have the Microsoft DLL Ctl3d or Ctl3dV2 installed for this option to be available.


Preferences|Mouse jumps

 The mouse pointer will automatically move ("Jump") to the default pushbutton in each dialog.

If unchecked the mouse pointer does not "Jump".


Preferences|Warning beeps

 Install / Easy accompanies warning dialogs & messages with the appropriate system sound.

If unchecked only catastrophic errors are accompanied with the appropriate system sound.


"Help" Button

Click or Press the "Help" button for help with this dialog

and the requirements for each of the dialog's data fields.


"Cancel" Button

Click or Press the "Cancel" button to close the

dialog without changing any of the data fields.


"OK" Button

Click or Press the "OK" to close the dialog

and accept the data as indicated.


"Close" Button

Click or Press the "Close" button to close the dialog.


Control|Size

Use the keyboard to change

the size of the window.


Control|Move

Use the keyboard to move

the window to another position.


Control|Minimize

Reduce the window to an icon.


Control|Maximize

Enlarge the window to it's maximum size.


Control|Next

Switch between open document windows and icons.


Control|Close

Close the window or dialog box.

(From an application window this

command will close the application).


Control|Restore

Restore the window to it's former size.


Control|Switch to...

Open Task List, which enables you to

switch between running applications and

rearrange windows and icons on your desktop


Edit|Cut

Deletes the selected (highlighted) information from

the document or file and places it onto the clipboard.


Edit|Copy

Copies the selected (highlighted) information

from the document or file onto the clipboard.

The original remains unchanged.


Edit|Paste

Copies the information currently on the clipboard

into the file or document at the insertion point.


Edit|Delete

Deletes the selected (highlighted)

information from the document or file.


Edit|Undo

Reverses the previous editing operation.


Help|Contents

Displays the Table of Contents of the application's "Help" file.

From that list you may select a topic of interest.


Help|Search for Help on...

Displays a dialog from which you may select a "Help" topic of interest, based on a keyword search.


Help|How to Use Help

Presents a tutorial on how to use the Windows Help system.


Help|About...

Displays some information about the Application, it's author, and your system.


Default Design
The Default Install / Easy design uses these properties:

  Top Color :	Blue (RGB 0,0,255)

  Bottom Color:	Black (RGB 0,0,0)

  Title Font: 	Times New Roman, Bold Italic, Size 48.

Color White, Black shadowing

  Footer Font:	Times New Roman, Bold Italic, Size 18

Color White, No shadowing

  Use 3d Dialogs 	NO


Create or Update INI Item radio buttons

The default is to always create or update this item.  If this item is installed as part of an "Optional Component" group check the appropriate radio button to install the item only when the installer has chosen to install that component.


Version Data Inspector

The Version Data inspector may be used to examine any Windows program for the presence and status of internal versioning data.  Both compressed and uncompressed files may be examined.  The DOS file date, time, size, and attributes are also provided.

The "Version Data Inspector" dialog contains the following fields and controls:

  Selected file name and path

  File Attributes

The Read-only, Hidden, Archive  and System boxes are checked if the file has that attribute.

  File Date and Time

The DOS date and time stamp of the last change or update   You may wish to use the "Date-Time Stamp" tool to set the date and time of all your Application's files to an arbitrary consistent value.  Many developers routinely stamp all files with the application release date and use the time fields to indicate version and revision numbers.

  File size

The size in bytes of the file.  If this is a compressed file, this is the size after compression.

  Version data

Version data is only available if the file contains a version resource.  The version resource should be included with all of your Windows executables because it is the version data version numbers that are used by the Windows installation routines to determine which files are the most recent.

This version of Install / Easy supports version checking using version resource data or DOS file dates.

  Close

Closes the dialog.

  New File...

Opens the "Version Inspector Choose File" dialog, where you may select another file to inspect.

  Help

Opens a Help window with information about the Version Data Inspector dialog.


Version Data - Select file
Version Data - Choose file

Select a file for which you wish to inspect the internal Versioning data:

After choosing the menu command TOOLS|Version Data... choose a file from the list of files under File Name, or type the name of the file in the File Name box.

You may also inspect a file on another drive or directory by first switching to that drive or directory.

The fields and controls in the Select File dialog are:

 File Name

Choose the name of the document you want to open or type the filename.

 List Files of Type

Choose the type of files you want listed:

   "Executables      *.EXE,*.DLL,*.EX_,*.DL_ files

   "All files"               *.* files

 Directories

Choose the directory containing the file you want.

 Drives

Choose the drive where the file you want is located.

 OK button

Click or Press the "OK" to close the dialog and inspect the specified file.

 Cancel button

Click or Press the "Cancel" button to close the dialog without inspecting a file.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


VDATA_POP_14102
New File...

Opens the "Version Inspector Choose File" dialog,  where you may select another file to inspect.


Tools|Version data...

Opens the Version Data inspector dialog which  may be used to examine any Windows program for  the presence and status of internal versioning data.


VDATA_POP_14401
Version data

Version data is only available if the file contains a version resource.  The version resource should be included with all of your Windows executables because it is the version data version numbers that are used by the Windows installation routines to determine which files are the most recent.

This version of Install / Easy supports version checking using version resource data or DOS file dates.


Prevent Changing Default Directory
Prevent Changing by Installer

Check the check box to prohibit the installer from modifying the specified directory.  If you do so, the directory is not displayed to the installer, nor is the directory checked for sufficient space for the application's files and programs.  Use caution specifying this option because if you specify a drive on the installer's machine that does not exist, the installation will fail.


Language Support

This version of Install / Easy supports several languages other than English.

INSTEASY.EXE is available only in an English version, but the INSTALL.EXE program is supplied with optional DLLs to support the languages listed below.  When you select a language (other than English) with the listbox on the "General Setup" dialog you must be sure to include the correct DLL as part of your distribution package.  Language support DLLs are required only for languages other than English.

Note that only a single language is supported for a distribution package.  If you require multiple language support you must provide a distribution package specific to each language.

Do all of the following to create a distribution package in a language other than English:

  Select the desired language from the listbox on the "General Setup" dialog.  Only languages on this list are currently supported.

  Add the correct DLL for the specified language to your "Application Program/Files" list.  The DLLs were originally installed into the same directory as INSTEASY.EXE and INSTALL.EXE.  Currently available languages and their required DLL are:

French	INSTAFRA.DLL

German	INSTADEU.DLL

Italian	INSTAITA.DLL

Portuguese	INSTAPTG.DLL

U.S. English	No DLL is required for U.S. English

  If you require these features, compose the text for the "Welcome Read-me" and the "Optional Components" dialogs in the language of choice.


Installer Language

Select the language of the intended installer from the drop-down list.  The default is US English.  If you select a language other than US English you must be sure to include the correct language support DLL with your application files on the distribution disks.  See the "Language Support" topic for a complete discussion


Date-Time Stamper

The Date-Time Stamper dialog can be used to "stamp" your application's files with a consistent date and time of last modification.  Many developers use this technique to mark all of the files in a application with a consistent release date.  Frequently the time field is used to indicate a version and revision number.  For example the first release of Install / Easy was June 1, 1994.  All of it's files were stamped: 06:01:94 01:01:00.

Choose "Date/Time Stamp..." from the TOOLS menu.  The fields and controls on the Date-Time Stamper dialog are:

  Year	Must range from 1980 to 2099.

  Month 	Must range from 1 to 12.

  Day	Must range from 1 to 31.

  Hour	24-hour time; must range from 00 (midnight) to 23 (11 PM).

  Minute	Must range from 0 to 59.

  Second	Must range from 0 to 58 and must be an even number.  (This is a DOS limitation.)

  Stamp All Files in Application Files List

     (or)

     Stamp All Application Files in Project Directory

This button will be labeled according to the preference setting for "Date/Time Stamp".  This button is available only when an INSTALL.INF file is: 1) loaded into the editor, 2) does not contain any unsaved changes, and 3) does contain at least one application file.

Stamp All Files in Application Files List

Press or click this button to "stamp" all of the files in the Application's file list with the specified date and time.  Every file that includes a path location will be changed.  Use caution with this setting.

Stamp All Application Files in Project Directory

Press or click this button to "stamp" only those files that are in the same directory as the INSTALL.INF file.

  Choose Files To Stamp...

Press or click this button to display the "Choose Files" dialog with which you may specify one or more files to be "stamped" with the specified date and time.  You may choose any file with this dialog, whether part of this application or not.

  Close Button

Click or press the "Close" button to close the dialog.

  Help Button

Click or press the "Help" button for help with this dialog, and the requirements for each of the dialog's data fields.


Date-Time Fields
Year	   Must range from 1980 to 2099.

Month 	    Must range from 1 to 12.

Day	    Must range from 1 to 31.

Hour	   24-hour time; must range from 00 (midnight) to 23 (11 PM).

Minute	    Must range from 0 to 59.

Second  Must range from 0 to 58 and must be an even number.  (This is a DOS limitation.)


Date-Time Stamp- All Files
(This button may have one of two labels):

Stamp All Files in Application Files List

Press or click this button to "stamp" all of the files in the Application's file list with the specified date and time.  Every file that includes a path location will be changed.  Use caution with this setting.

Stamp All Application Files in Project Directory

Press or click this button to "stamp" only those files that are in the same directory as the INSTALL.INF file.


Tools|Date-Time Stamp
Tools|Date/Time Stamp...

Opens the "Date-Time Stamper" dialog which can be used to "stamp" your application's files with a consistent date and time of last modification.


Date-Time Stamp-Choose Files
Choose Files To Stamp...

Press or click this button to display the "Choose Files" dialog with which you may specify one or more files to be "stamped" with the specified date and time.  You may choose any file with this dialog, whether part of this application or not.


Preferences|Date/Time Stamp

Install / Easy can "stamp" your application's files with a consistent Date/Time.

One of the following two options must be chosen:

     All Items - All the application's files will be date-time "stamped".

 Only Items in Project Directory  - Only the application files in the project directory will be date-time "stamped" (default).


Preferences|Compression
Compression

Install / Easy will execute the Microsoft COMPRESS.EXE utility if you desire.

One of the following three options must be chosen:

 In View - File compression takes place in a visible window (default).

     Hidden - File compression takes place hidden from view.

     As Icon - File compression takes place as an icon on the desktop.


Tools|Compress...

This version of Install / Easy supports file compression with the Microsoft utility COMPRESS.EXE.  This menu provides access to the "Compress Files" dialog where you may run COMPRESS.EXE to compress the application's files.  You must have the COMPRESS.EXE utility installed to use this feature.


Tools|Copy to Install Disks...

Copies all of the application's files to their respective installation disks, prompting you to load each as needed.  This menu option is only available when an INSTALL.INF file is loaded and contains no unsaved changes.


Compress Files

This version of Install / Easy supports compression using the Microsoft program COMPRESS.EXE.  See the "File Compression" topic for a general discussion of file compression techniques.

The data fields and controls on the "Compress Files" dialog are:

  Files button

Click or press this button to open a "Choose Files" dialog with which you may select the programs and files you wish to compress.  If this button is not available you must first press the "Configure.." button to specify the location of the COMPRESS.EXE program.

You may compress any of your files and programs except for INSTALL.EXE and INSTALL.INF.

If an INSTALL.INF file has been opened you will be asked if you wish to add the compressed files to the application's Program/file list.  Files already in the list are updated with the new sizes.

NOTE  You must be careful not to "mix" the names of compressed and uncompressed files.  If you have added an uncompressed file name to the list (PROG.EXE, for example) and then later compress it, the name of the compressed version will be "PROG.EX_".  Adding this name to the Program/file list will NOT replace the existing "PROG.EXE".  You must do so manually by deleting PROG.EXE using the "Application Files" dialog.

  Cancel button

Click or press this button to close the dialog without compressing any files.  If you press this button after compression has been started, the "cancel" takes effect at the completion of compressing the current file.

  Configure button..

"Configure" allows you to specify the location of the Microsoft COMPRESS.EXE program.  When you first install Install / Easy, the program attempts to locate COMPRESS.EXE on your system.  If is is unsuccessful the "Files.." button is unavailable until you use the "Configure" option to specify the location.  You must also use the "Configure" option if Install / Easy has located and attempts to use some other program named COMPRESS.EXE.

  Help button

Click or press the "Help" button for help with this dialog, and the requirements for each of the dialog's data fields.

  Compress radio buttons

The three radio buttons "In View", "Hidden", and "Icon" control how the COMPRESS program is to be run.  These buttons correspond to the choices on the PREFERENCES|Compression menu, but effect only the current operation.  To establish new defaults, use the Preferences menu.

Choosing a radio button selection will alter the display at the earliest possible time.  It is not possible to change from "In View" to "Hidden" or "Icon" because the "In View" option pauses at the end of each compression cycle so you may review the activity.

If you are running Windows in Standard mode, only the "In View" option is available.

  Program/File List

The list contains the name of each program compressed, it's original and compressed sizes, and the percentage saved.  The percentage saved is replaced by a warning message ("<<NOTE!") if the compression results in a size that is larger than the original (which can occur with certain files).  If this occurs you will want to delete the compressed file name from the application's file list (if it was added) and substitute the original name.

Above the list is the name of the program currently being compressed.

Below the list are some summary totals and elapsed times.


Copy to Installation Disks

Install/Easy will copy all of the application's files to the installation disks to create the distribution package.  Select the appropriate disk drive from the "Tools|Copy to Install Disks..." menu.  (You should select the drive based on the way you allocated the application's files in the "Distribution Disks" dialog).  This menu option is only available when an INSTALL.INF file is loaded and contains no unsaved changes.  At a minimum, the application's file list must contain references to the installation programs INSTALL.EXE and INSTALDR.EXE, and the application's INSTALL.INF file

INSTALL.INF normally contains the location of all the application's files.  If the files have been moved and INSTALL.INF was not updated, creation of the distribution disks will fail.

Have on hand a blank, formatted diskette for each installation disk required before you begin.  The creation process must run to completion; it can be restarted only from the beginning.

The following problems or errors may occur, and will cause the creation process to fail:

  One or more application files have not been assigned to a distribution disk.  Use the "Distribution Disks" dialog to correct.

  File not found at specified location.  Use the "Application Files" dialog to supply the correct location.

  There is insufficient room on an installation disk to contain all of the assigned programs and files.  Use the "Distribution Disks" dialog to correct by reassigning some files to another disk.

  Unable to write to drive.  Correct drive failure or replace defective diskette.

  Access denied.  Some other program has the specified file open in exclusive mode.  Terminate the other program and restart the copy process.

  Other Error.  See your DOS manual for an explanation of the indicated error code.


INSTALL.INF

 Install / Easy creates an application installation control file called INSTALL.INF.  This file is used by INSTALL.EXE and INSTALDR.EXE to install your application's programs and files on the installer's computer.  You will supply your programs and files, the INSTALL.INF control file, and the programs INSTALL.EXE and INSTALDR.EXE on your distribution disk(s).


Application's Files
Applications's Files

The application's files at a minimum consist of the installer program INSTALL.EXE and the control file INSTALL.INF.  In addition you will include all of your application's programs, files, read-me documentation, etc.  If you need support for a language other than English, you will include the appropriate DLL.


Compress - Choose Files

Select one or more files that you wish to compress.

After choosing the menu command TOOLS|Compress... choose one or more files from the list of files under File Name, or type the name of the files in the File Name box.

Be careful not to choose files that are already compressed (extension ending with an underscore; example: PROG.EX_).  You may choose the original name (PROG.EXE in this example) and the existing compressed version will be replaced.

NOTE:  If you wish to have the compressed files added to the application's file list, you must have the application's INSTALL.INF file open.

You may also select files on another drive or directory by first switching to that drive or directory.

The fields and controls in the "Choose Files" dialog are:

 File Name

Choose the name of the file you want to compress.

 List Files of Type

Choose the type of files you want listed:

   "Executables      *.EXE,*.DLL files

   "All files"               *.* files

 Directories

Choose the directory containing the files you want.

 Drives

Choose the drive where the files you want are located.

 OK button

Click or Press the "OK" to close the dialog and compress the specified files.

 Cancel button

Click or Press the "Cancel" button to close the dialog without compressing any files.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Compress - Configure

Specify the location of the Microsoft program COMPRESS.EXE.

You may specify a location in another directory by first switching to that drive or directory.

The fields and controls in the "Locate COMPRESS.EXE" dialog are:

 File Name

Must be COMPRESS.EXE

 List Files of Type

Choose the type of files you want listed:

   "MS Compress"    COMPRESS.EXE

   "All files"                   *.* files

 Directories

Choose the directory containing COMPRESS.EXE

 Drives

Choose the drive where COMPRESS.EXE is located.

 OK button

Click or Press the "OK" to close the dialog and accept the specified location.

 Cancel button

Click or Press the "Cancel" button to close the dialog without specifying a location.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Project Directory

The "Project Directory" is the directory in which INSTALL.INF is located.  Normally the project directory will contain all of the application's distributable files and programs, though it is not required to do so.

The "Date-Time Stamp" tool makes use of the project directory to allow selectively "stamping" programs and files, without changing common files or DLLs that you may be including.  For example, if you are distributing a 3rd party DLL (like the Microsoft CTL3D.DLL that is shipped with Install/Easy), you would not normally change it's file date.  Similarly INSTALL.EXE will be included with your distribution package, but would not normally be placed in your project directory.


Distribution Package

The "package" of all your application's files, programs, documentation, etc. plus INSTALL.EXE, INSTALDR.EXE and INSTALL.INF (and any language support DLL), as prepared for installation on the installer's computer.


Converting from an earlier version of Install / Easy

The editor program INSTEASY.EXE supplied with this release will read and convert .INF files from all previous versions of Install / Easy.  (It will not read .INF files produced by any other product).  The install programs INSTALL.EXE and INSTALDR.EXE supplied with this release will also read .INF files from all previous versions, but may not process some of the data correctly.

Previous versions of Install /Easy will not read .INF files produced by later versions.

To avoid compatibility problems you should convert all of your INSTALL.INF files to the current version and use only the latest releases of INSTEASY.EXE, INSTALL.EXE and INSTALDR.EXE.  Conversion can be as simple as loading the .INF file into the editor and then saving it.  Some areas that are known to require changes:

  You must update the locations of all files and programs if you intend to use the "Copy to Installation Disks" or the "Date-Time Stamp" features.  Do this from the "Application Programs/Files" dialog by selecting the "Add Files" feature.  (Selecting existing files updates their data rather than adding them again).

  Any references in the "Program Manager Program Item" data to the "Other/Not Required" directories will need to be changed to specify either "Other" or "Not Required".

  You will of course, have to make changes to use any of this version's new features.


Files_Add_list_Pop
Add list...

Click or press this button to add or update a list of Programs and/or Files.  You will be presented with a standard "Choose Files" dialog from which you may make a selection of one or many programs or files.  If a chosen program or file does not exist in the Program/File list, it will be added to the list and the file size (both compressed and uncompressed), the description from the version data resource (if any), and the file location will be entered.  If the file name exists in the list, the description, sizes and location are updated.


Prog_File_Browse_Pop
Find Program/File

Press or click the button to open a "Choose File" dialog from which you may select a file or program to be added to the application's list.  If you are adding a file, you may select any file that does not already exist in the list.  If you are updating an existing file, you must select the file with the name specified in the "Program/File Name" field.  If a chosen program or file does not exists in the Program/File list, it will be added to the list and the file size (both compressed and uncompressed), the description from the version data resource, and the file location will be entered.  If the file name exists in the list, the description, sizes and location are updated.


Prog_File_Location_Pop
Program/File location

This field displays the location of the file on your development system.  The location must be specified correctly as a valid DOS directory beginning with a drive letter.  You may enter the location directly, or use the "Find Program/File" browse button.  If an application file is moved to a different directory on your development system after it has been entered here, you must update it's location.

Install/Easy's "Copy to Installation Disks"feature will only copy files with a specified location to the installation disks.


Choose Application Files to Add or Update

Select one or more programs/files that you wish to add to the application, or files already added that you wish to update.  Choose one or more files from the list of files under File Name, or type the names of the files in the File Name box.

You may also select files on another drive or directory by first switching to that drive or directory.

The fields and controls in the "Choose Files" dialog are:

 File Name

Choose the names of the programs and files or type the filenames.

 List Files of Type

Choose the type of files you want listed:

   "Executables      *.EXE,*.DLL,*.EX_,*.DL_ files

   "All files"               *.* files

 Directories

Choose the directory containing the files you want.

 Drives

Choose the drive where the files you want are located.

 OK button

Click or Press the "OK" to close the dialog and add/update the specified files.

 Cancel button

Click or Press the "Cancel" button to close the dialog without adding or updating any files.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


Choose Application File to Add or Update

Select a file that you wish to add to the application, or a file already added that you wish to update.  Choose a files from the list of files under File Name, or type the name of the file in the File Name box.

You may also select a file on another drive or directory by first switching to that drive or directory.

The fields and controls in the "Choose File" dialog are:

 File Name

Choose the name of the program or file you want to open or type the filename.

 List Files of Type

Choose the type of files you want listed:

   "Executables      *.EXE,*.DLL,*.EX_,*.DL_ files

   "All files"               *.* files

 Directories

Choose the directory containing the file you want.

 Drives

Choose the drive where the file you want is located.

 OK button

Click or Press the "OK" to close the dialog and add/update the specified file.

 Cancel button

Click or Press the "Cancel" button to close the dialog without adding or updating any file.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


CMPR_Pop_Cancel
Cancel button

Click or press this button to close the dialog without compressing any files.  If you press this button after compression has been started, the "cancel" takes effect at the completion of compressing the current file.


CMPR_Pop_Files
Files button

Click or press this button to open a "Choose Files" dialog with which you may select the programs and files you wish to compress.  If this button is not available you must first press the "Configure.." button to specify the location of the COMPRESS.EXE program.

You may compress any of your files and programs except for INSTALL.EXE and INSTALL.INF.

If an INSTALL.INF file has been opened you will be asked if you wish to add the compressed files to the application's Program/file list.  Files already in the list are updated with the new sizes.


CMPR_Pop_Configure
Configure button..

"Configure" allows you to specify the location of the Microsoft COMPRESS.EXE program.  When you first install Install / Easy, the program attempts to locate COMPRESS.EXE on your system.  If is is unsuccessful the "Files.." button is unavailable until you use the "Configure" option to specify the location.  You must also use the "Configure" option if Install / Easy has located and attempts to use some other program named COMPRESS.EXE.


CMPR_Pop_Radios
Compress radio buttons

The three radio buttons "In View", "Hidden", and "Icon" control how the COMPRESS program is to be run.  These buttons correspond to the choices on the PREFERENCES|Compression menu, but effect only the current operation.  To establish new defaults, use the Preferences menu.

Choosing a radio button selection will alter the display at the earliest possible time.  It is not possible to change from "In View" to "Hidden" or "Icon" because the "In View" option pauses at the end of each compression cycle so you may review the activity.

If you are running Windows in Standard mode, only the "In View" option is available.


CMPR_Pop_List
Program/File List

The list contains the name of each program compressed, it's original and compressed sizes, and the percentage saved.  The percentage saved is replaced by a warning message ("<<NOTE!") if the compression results in a size that is larger than the original (which can occur with certain files).  If this occurs you will want to delete the compressed file name from the application's file list (if it was added) and substitute the original name.

Above the list is the name of the program currently being compressed.

Below the list are some summary totals and elapsed times.


PROG_Install_Regardless_Pop
Install Regardless

If the checkbox is checked the installer program will not check for an existing later version before installing this program/file.  This overrides the default, which is to always check versions.  See the "Version Control" topic for more information.


Design Main Install Window

This dialog simulates how the main window of the INSTALL.EXE program appears to the installer.  You may change the colors and fonts used to achieve a "look" that is appropriate to your application.  The area containing the controls is the same size and position as the "Welcome Read-Me" dialog, to give you a better idea of how the screen will appear.

IMPORTANT NOTE:  Be certain to test the INSTALL program with your design at all Windows screen resolutions!  Some combinations of font sizes may not be readable at some resolutions!

The controls available on the "Design Install Window" dialog are:

  Top Color

The window background is "dithered" ( faded) from the top color to the bottom color.  If you prefer a solid color background, specify the same color for both "Top" and "Bottom".  Click or Press the "Top Color" button to switch to a standard Windows "Choose color" dialog where you may make your choice of available system colors, or design your own custom color.

  Bottom Color

Click or Press the "Bottom Color" button to switch to a standard Windows "Choose color" dialog where you may make your choice of available system colors, or design your own custom color.

  Title Font

Click or Press this button to switch to a standard Windows "Choose Font" dialog where you may specify the typeface, size, color, and effects to be used for the Main Install Window Title.  This button is unavailable if you have not entered a Main Window Title on the "General Setup" dialog.

You may specify any TrueType  font on your system, but if the same font is not available on your installer's system Windows  will substitute the closest equivalent that it can provide.  This may lead to unexpected results!  In order to avoid substitution problems it is wise to confine the fonts you use to those that ship with Windows:  Arial, Courier New, and Times New Roman.

  Footer Font

Click or Press this button to switch to a standard Windows "Choose Font" dialog where you may specify the typeface, size, color, and effects to be used for the Main Install Window Footer.  This button is unavailable if you have not entered a Main Window Footer on the "General Setup" dialog.

  Use 3-d Dialogs at INSTALL ?

Choose "Yes" to use 3-d dialogs when installing.  Choose "No" to use standard dialogs.  The installer must have either CTL3DV2.DLL or CTL3D.DLL installed on their computer for "Yes" to be effective.  If neither of the DLLs are present the INSTALL program will use the normal dialog style.  You can guarantee the use of 3-d dialogs by including CTL3D.DLL (compressed or uncompressed) on your first Installation disk.  You do not need to install CTL3D, just include it.

NOTE:  If you choose "Yes" you may not install an updated version of these DLLs with your application.  This is because they will be in use by Windows during the installation and therefore cannot be overwritten.

  Default

Click or Press the "Default" button to return to the default Install / Easy design.  The current design will be replaced.

 OK button

Click or Press the "OK" to close the dialog and accept the design as indicated.

 Cancel button

Click or Press the "Cancel" button to close the dialog without changing any of the design.

 Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's design pushbuttons.


Choose Font

You may specify the typeface, size, color, and effects to be used for the Main Install Window Title.or the Main Install Window Footer.

You may specify any TrueType  font on your system, but if the same font is not available on your installer's system Windows  will substitute the closest equivalent that it can provide.  This may lead to unexpected results!  In order to avoid substitution problems it is wise to confine the fonts you use to those that ship with Windows:  Arial, Courier New, and Times New Roman.

IMPORTANT NOTE:  Be certain to test the INSTALL program with your design at all Windows screen resolutions!  Some combinations of font sizes may not be readable at some resolutions!

The controls available on the "Choose Font" dialog are:

  Font

Type the name of the desired font or choose it from the list box.

  Font Style

Type the name of the desired style or choose it from the list box.

  Size

Type the size of the desired font or choose it from the list box.  Unlike the font name and style attributes, you may enter any size here, whether it is listed or not.

  Effects

Check the appropriate box(s) to show the text with a line through the middle, or as underlining.  Uncheck both boxes for normal font.

  Shadowing

Choose a shadow effect from the drop-down list box.  Some effects are not useful on all background colors, nor with some sizes of font.

  Color

Choose the font color from the drop-down list.

  OK button

Click or Press the "OK" to close the dialog and accept the selected font.

  Cancel button

Click or Press the "Cancel" button to close the dialog without changing the font.

  Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's input fields and controls.


Choose Main Install Window Color

The Main Install Window background is "dithered" ( faded, or mixed) from the top color to the bottom color.  If you prefer a solid color background, specify the same color for both "Top" and "Bottom".  You may make your choice of available system colors, or design your own custom color.  Custom colors remain available for this and other projects until you change them.

The controls and data fields on the "Choose Color" dialog are:

  Basic Colors

The Basic Colors control displays up to 48 colors, depending on the display driver in use

  Custom Colors.

You may select one of the 16 rectangles and then create a custom color by using one of the following methods :

  1)  Specify the  red, green, and blue (RGB) values by using the Red, Green, and Blue edit controls, and then choose the "Add to Custom Colors" button to display the new color in the selected rectangle.

  2)  Move the cursor in the color spectrum control (at the upper-right of the dialog box) to select hue and saturation values.  Then move the cursor in the luminosity control (the rectangle to the right of the spectrum control); and then choose the "Add to Custom Colors" button to display the new color in the selected rectangle.

  3)  Specify hue, saturation (Sat.), and luminosity (Lum.) values by using the Hue, Sat, and Lum edit controls and then choose the "Add to Custom Colors" button to display the new color in the selected rectangle.

  Color/Solid

The Color|Solid rectangle displays the dithered and solid colors that correspond to your selection.

  Hue/Saturation/Luminosity

These edit fields may be used to directly change the values of the selected custom color.

  Red/Green/Blue

These edit fields may be used to directly change the values of the selected custom color.

  Add to Custom Colors

Click or Press this button to add the designed custom color to the selected custom colors rectangle.

  OK button

Click or Press the "OK" to close the dialog and accept the selected color.

  Cancel button

Click or Press the "Cancel" button to close the dialog without changing the color.

  Help button

Click or Press the "Help" button for help with this dialog and the requirements for each of the dialog's data fields.


SETUP_POP_2180
Design Install Window Button

Click or press the "Design Install Window"button to commit the changes that have been entered on the "General Setup" dialog (same as pressing "Ok") and start the Install Window designer dialog.  This dialog allows you to customize the appearance of the main window of INSTALL.EXE.


MAIN_POP_24101
Top Color

The window background is "dithered" ( faded) from the top color to the bottom color.  If you prefer a solid color background, specify the same color for both "Top" and "Bottom".  Click or Press the "Top Color" button to switch to a standard Windows "Choose color" dialog where you may make your choice of available system colors, or design your own custom color.


MAIN_POP_24102
Bottom Color

Click or Press the "Bottom Color" button to switch to a standard Windows "Choose color" dialog where you may make your choice of available system colors, or design your own custom color.


MAIN_POP_24201
Title Font

Click or Press this button to switch to a standard Windows "Choose Font" dialog where you may specify the typeface, size, color, and effects to be used for the Main Install Window Title.  This button is unavailable if you have not entered a Main Window Title on the "General Setup" dialog.


MAIN_POP_24202
Footer Font

Click or Press this button to switch to a standard Windows "Choose Font" dialog where you may specify the typeface, size, color, and effects to be used for the Main Install Window Footer.  This button is unavailable if you have not entered a Main Window Footer on the "General Setup" dialog.


MAIN_POP_24302
Default

Click or Press the "Default" button to return to the default Install / Easy design.  The current design will be replaced.


MAIN_POP_24350
Use 3-d Dialogs at INSTALL ?

Choose "Yes" to use 3-d dialogs when installing.  Choose "No" to use standard dialogs.  The installer must have either CTL3DV2.DLL or CTL3D.DLL installed on their computer for "Yes" to be effective.  If neither of the DLLs are present the INSTALL program will use the normal dialog style.  You can guarantee the use of 3-d dialogs by including CTL3D.DLL (compressed or uncompressed) on your first Installation disk.  You do not need to install CTL3D, just include it.

NOTE:  If you choose "Yes" you may not install an updated version of these DLLs with your application.  This is because they will be in use by Windows during the installation and therefore cannot be overwritten.